Construire avec Delivo
Une API simple pour pousser vos commandes, lire votre file d'expédition et afficher de vrais prix de livraison dans votre tunnel d'achat. En phase de lancement : tout ce qui est documenté ici fonctionne, le reste est annoncé comme « à venir » — jamais l'inverse.
Deux clés, deux usages
| Clé | Préfixe | Ce qu'elle permet | Où l'utiliser |
|---|---|---|---|
| Clé privée | dlv_… | Lire et créer des commandes sur votre compte. | Votre serveur UNIQUEMENT — jamais dans du code visible par le navigateur. |
| Clé publique | dlvpk_… | Obtenir des devis de livraison (checkout). Elle ne lit rien, ne crée rien. | Côté navigateur, dans votre boutique — c'est fait pour. |
Les deux se génèrent (et se révoquent en un clic) depuis votre espace : Automatisations → Clé API et Automatisations → Checkout de ma boutique.
Commandes — /api/v1/orders
# Lire vos commandes à expédier
curl https://delivo.pro/api/v1/orders \
-H "Authorization: Bearer dlv_votre_cle"
# Créer une commande
curl -X POST https://delivo.pro/api/v1/orders \
-H "Authorization: Bearer dlv_votre_cle" \
-H "Content-Type: application/json" \
-d '{"customer":"Emma Girard","address":"12 rue des Lilas",
"zip":"69003","city":"Lyon","weight":0.8,"items":"Bougie"}'La commande créée entre dans votre file avec les mêmes garde-fous que la saisie manuelle : règles d'expédition appliquées, vérification d'adresse, statut « à vérifier » avant l'étiquette. La virgule décimale est acceptée sur le poids.
Checkout — vos prix de livraison dans votre boutique
Avec la clé publique, votre tunnel d'achat affiche les options de livraison et leurs vrais prix, calculés par Delivo à chaque appel : vous changez vos règles (livraison offerte dès X €, majoration, options proposées), le checkout suit sans retoucher votre site. L'extrait à coller — quelques lignes — se copie depuis Automatisations → Checkout de ma boutique, réglages compris.
Plugin WooCommerce officiel
Pour les boutiques WordPress : le plugin Delivo for WooCommerce — expédition & points relais génère la clé de connexion en un clic (plus rien à chercher dans les réglages WooCommerce) et ajoute, en option, la carte des points relais au checkout — le point choisi par l'acheteur arrive dans Delivo déjà sélectionné sur la commande.
Télécharger le plugin (.zip) — à installer via Extensions → Ajouter → Téléverser. Publication sur le répertoire WordPress.org en cours.
Module PrestaShop officiel (bêta)
Même principe pour PrestaShop : le module Delivo — expédition & points relais crée la clé Webservice avec exactement les bons droits en un clic (fini la grille de permissions à cocher) et ajoute, en option, la carte des points relais sous le choix du transporteur au checkout — le point choisi remonte dans Delivo avec la commande.
Télécharger le module (.zip) — à installer via Modules → Installer un module (PrestaShop 1.7 et 8). Version bêta : un retour, un souci ? Écrivez-nous depuis la page Aide.
Widget — la carte des points relais dans votre checkout
Un composant clé en main, sans clé d'API et sans GAFA (fond de carte OpenStreetMap) : votre page de commande affiche les points relais autour du client, il en choisit un, votre page le reçoit. Une iframe et un écouteur d'événement :
<!-- 1. La carte, là où vous voulez -->
<iframe src="https://delivo.pro/widget/relais?cp=75011&reseau=mondial-relay"
style="width:100%;height:520px;border:0" title="Choisir un point relais"></iframe>
<!-- 2. Le point choisi arrive par postMessage -->
<script>
window.addEventListener("message", (e) => {
if (e.data && e.data.source === "delivo-relais") {
// e.data.relais = { id, nom, adresse, cp, ville }
console.log("Relais choisi :", e.data.relais);
}
});
</script>Paramètres : cp (code postal de départ), pays (FR par défaut) et reseau — mondial-relay, ups, fedex ou courrier (points de contact La Poste). Chaque réseau affiche uniquement SES points : l'identifiant renvoyé est celui que le transporteur attend sur l'étiquette.
Widget — le calculateur de frais de port sur votre site
Pour un blog, un forum, un site d'association ou une page d'aide : le configurateur public de Delivo (destination, poids → toutes les offres triées par prix, le même moteur que le tunnel) en une iframe. Aucune clé, aucune bannière de consentement ; le visiteur qui clique une offre arrive sur delivo.pro, prérempli.
<iframe src="https://delivo.pro/widget/devis?dest=FR"
style="width:100%;height:640px;border:0" title="Calculer le prix d'un envoi de colis"></iframe>Paramètres : dest (pays présélectionné, FR par défaut) et accent (couleur hexadécimale). Le widget annonce sa hauteur par postMessage (source: "delivo-devis"), comme la carte des points relais.
Webhooks et connecteurs Zapier / Make
Les webhooks se configurent depuis l'app (Automatisations → Webhooks) ; certains événements sont encore marqués « à venir » et le disent. Pour Zapier ou Make dès aujourd'hui : le bloc « Webhooks / Custom Request » avec l'en-tête d'autorisation ci-dessus fonctionne — un connecteur officiel viendra avec l'ouverture publique de l'API.
Sécurité — les règles qu'on s'applique
La clé privée n'est jamais renvoyée après sa création (stockée hachée), la clé publique ne donne accès à aucune donnée, et les identifiants de vos boutiques sont chiffrés (AES-256-GCM) dans un coffre côté serveur. Données hébergées dans l'Union européenne — le détail est sur la page sécurité et dans la politique de confidentialité (liste des sous-traitants comprise).