API livraison Algérie gratuite : DZShip pour Yalidine, ZR et Ecotrack

Oui, une API livraison Algérie gratuite existe : DZShip, exploitée par DZBuild sur freeship.dzbuild.com. Elle sert à créer des colis en paiement à la livraison (COD), à les suivre, à demander un tarif et à lister les stop desks chez 99 transporteurs algériens, avec une seule forme de requête. Selon la FAQ du service, lue le 3 novembre 2026, il n'y a ni inscription, ni clé API, ni frais par colis.

Le principe est simple : chaque appel contient vos propres identifiants chez le transporteur (Yalidine, ZR Express, NOEST, un transporteur Ecotrack, etc.). Le colis est créé sur votre compte transporteur, qui vous facture la livraison comme aujourd'hui et vous reverse l'argent encaissé. DZBuild affirme que les identifiants servent à un seul appel et ne sont jamais stockés.

Ce guide s'adresse aux développeurs et aux agences qui veulent intégrer les sociétés de livraison à un site web en Algérie sans écrire un connecteur par transporteur. Commerçant sans développeur ? Voyez la dernière section.

En bref :

• Gratuit : pas d'inscription, pas de clé API, pas de frais par colis. Les frais de livraison du transporteur restent dus.
• Couverture : 99 transporteurs, dont la famille Yalidine, ZR Express (Procolis et nouvelle plateforme), Maystro, NOEST, Zimou, Elogistia et 82 transporteurs Ecotrack.
• Fonctions : création de colis, suivi avec 14 statuts communs, tarifs, stop desks, wilayas et communes.
• Test : un transporteur « sandbox » valide vos requêtes sans créer de colis.
• Sécurité : appels depuis votre serveur pour protéger vos identifiants, quotas d'usage raisonnable par IP, et le COD reste chez votre transporteur.

API livraison Algérie gratuite : ce qu'est DZShip

DZBuild a annoncé DZShip dans un billet de blog daté du 12 juillet 2026, où il le présente comme une API de livraison gratuite et publique pour l'Algérie. La raison avancée par l'entreprise : chaque transporteur algérien a une API différente, et la plupart ne sont pas documentées.

Trois points à retenir avant de vous lancer :

• Ce qui est gratuit, c'est l'accès à l'API. Votre transporteur continue de facturer chaque livraison selon votre contrat avec lui.
• Seule une partie est open source. Les guides par transporteur et les clients sont sous licence MIT, et le jeu de données des 58 wilayas et 1 541 communes (noms en français et en arabe, JSON et CSV) est dans le domaine public (CC0). Le service hébergé lui-même (adaptateurs, passerelle, infrastructure) reste propriétaire de DZBuild : vous ne pouvez pas l'installer chez vous.
• Le public visé est large. Selon le site, DZShip s'adresse à toute personne qui construit pour l'Algérie : une boutique, une landing page, un ERP ou une feuille Google Sheets de commandes.

Transporteurs pris en charge : API Yalidine, API ZR Express, API Maystro et Ecotrack

L'endpoint GET /v1/couriers renvoie, pour chaque transporteur, sa clé, sa plateforme et les identifiants exigés. Voici les principaux, avec ce qu'il faut savoir côté intégration :

• Yalidine et ses réseaux frères (Yalitec, Guepex, Easy & Speed, Economiqua, We Can)
• Identifiants : apiId et apiToken, plus la wilaya d'origine (options.fromWilaya).
• À savoir : selon DZBuild, l'accès à l'API Yalidine demande en général un compte professionnel vérifié. Les conditions de transport de Yalidine plafonnent le COD à 150 000 DZD par colis. Détails dans notre guide Yalidine tarif livraison.
• ZR Express, sur ses deux plateformes
• Procolis (ancienne API) : token et key. Pas de liste de stop desks par API : la requête desks renvoie une erreur 422 NOT_SUPPORTED.
• Nouvelle plateforme zrexpress.app : apiKey et tenantId. C'est elle qu'il faut utiliser si le client doit choisir un stop desk nommé.
• À savoir : ZR Express plafonne aussi le COD à 150 000 DZD par colis. Voir notre guide ZR Express et Procolis.
• Maystro Delivery
• Pris en charge par DZShip. Les colis en stop desk sont routés par commune, sans identifiant de desk.
• NOEST
• Identifiants : API Token et User GUID, tirés du tableau de bord marchand.
• À savoir : le guide DZShip consacré à NOEST signale que les commandes créées par API restent des brouillons tant qu'une étape de validation séparée n'a pas été lancée. Il indique aussi que NOEST accepte, via l'API, l'ouverture du colis avant paiement et les échanges.
• Les transporteurs Ecotrack (82 selon DZShip : DHD, Conexlog, MSM Go, Rocket, World Express, Anderson, etc.)
• Identifiants : un seul token par transporteur.
• À savoir : Ecotrack est un logiciel, pas un livreur. Un transporteur Ecotrack absent de la liste peut être appelé via options.baseUrl, à condition que son hôte soit en .ecotrack.dz. Les colis stop desk sont routés par commune. Voir notre guide Ecotrack pour l'API Ecotrack et son intégration.
• Zimou Express, Elogistia, Colivraison et autres (Ecom Delivery, Near Delivery, MDM)
• Elogistia route les colis stop desk par commune. Colivraison, comme ZR Express sur Procolis, ne publie pas de liste de desks par API.

DZShip ne change rien aux conditions des transporteurs : pour les choisir, voyez notre comparatif des sociétés de livraison en Algérie.

Comment ça marche : identifiants, endpoints et sandbox

Chaque corps de requête suit la même structure : courier (une clé issue de /v1/couriers), credentials (les champs propres à ce transporteur) et les données de l'opération. Changer de transporteur revient à modifier ces deux premiers champs.

Les endpoints disponibles :

• POST /v1/orders : créer un colis.
• POST /v1/track : statut actuel et historique complet des événements.
• POST /v1/rates : frais de livraison et de retour pour un trajet.
• POST /v1/desks : stop desks d'un transporteur dans une wilaya.
• GET /v1/couriers, /v1/wilayas et /v1/communes : données de référence.
• GET /openapi.json et /llms.txt : le contrat complet, lisible par une machine ou un agent IA.

Les règles de validation qui font échouer les premières requêtes :

• deliveryType vaut « home » (domicile) ou « stopdesk ». Pour un desk, récupérez son id avec /v1/desks et envoyez-le dans order.stopDeskId.
• phone doit être un mobile algérien (05, 06 ou 07).
• wilayaCode va de 1 à 58. L'Algérie compte 69 wilayas depuis avril 2026, mais selon DZShip aucun transporteur n'accepte encore un code supérieur à 58. GET /v1/wilayas?all=1 renvoie les 69, chacune avec le code « shipAs » à utiliser.
• communeName doit suivre l'orthographe française du transporteur : prenez-la dans /v1/communes plutôt que de mémoire.
• codAmount est un entier en DZD ; 0 signifie un colis prépayé.

Le suivi ramène le vocabulaire de chaque transporteur à 14 statuts communs, avec libellés français et arabes : created, pending_pickup, picked_up, in_transit, at_hub, out_for_delivery, delivery_attempted, delivered, on_hold, return_in_transit, returned, cancelled, lost et unknown. Le statut brut du transporteur est conservé.

Exemple : créer, suivre et tarifer un colis COD avec la sandbox

Voici le parcours minimal, d'après la documentation des endpoints :

1. Tester sans compte. Envoyez un POST /v1/orders avec courier « sandbox », sans credentials. Dans order : un destinataire (nom complet, téléphone 0551234567, wilayaCode 16, communeName « Bab Ezzouar »), deliveryType « home », une productList et codAmount 4500. La sandbox valide comme un vrai transporteur, sans créer de colis.
2. Passer au vrai transporteur. Remplacez courier par « yalidine », ajoutez credentials (apiId, apiToken), options.fromWilaya 16, une adresse (addressLine) et votre propre reference, par exemple « ORD-1042 ». La réponse contient le trackingNumber, le statut « created » et votre référence.
3. Suivre. POST /v1/track avec le même courier, les mêmes credentials et le trackingNumber. Vous recevez le statut commun et la liste des événements, du plus ancien au plus récent.
4. Tarifer. POST /v1/rates avec une query : fromWilaya 16, toWilaya 31, toCommune « Oran », deliveryType « home ». Le champ query.tier accepte « express » (par défaut) ou « economic » quand le transporteur propose une voie plus lente et moins chère.
5. Proposer un stop desk. POST /v1/desks avec la wilaya visée. En sandbox, la réponse contient un desk de test à Oran.

DZBuild publie des clients sous licence MIT pour Node.js (paquet npm « dzship », version 1.2.0 au 3 novembre 2026, sans dépendance, avec types TypeScript), PHP, Python et Ruby. Le dépôt donne aussi des exemples pour Laravel, WooCommerce, Django, Rails et Google Sheets.

Quotas d'usage, sécurité et bonnes pratiques

Les quotas d'usage raisonnable, lus le 3 novembre 2026 :

• 200 commandes par heure et 1 000 par jour, par adresse IP ;
• 10 commandes par jour pour un même numéro de destinataire ;
• 60 appels de suivi par minute et 5 000 par jour, par IP ;
• 60 demandes de tarif et 60 listes de desks par minute, par IP.

Au-delà, l'API répond HTTP 429 : attendez le nombre de secondes indiqué dans l'en-tête Retry-After avant de réessayer. Les endpoints de référence envoient un en-tête Cache-Control : mettez-les en cache au lieu de les interroger en boucle.

Les bonnes pratiques :

• Appelez depuis votre serveur, pas le navigateur. DZBuild est explicite : vos identifiants transporteur seraient lisibles par n'importe quel visiteur. Passez toujours par votre serveur.
• Vérifiez avant de renvoyer une création. DZShip ne relance jamais automatiquement une création, car un nouvel essai crée un doublon. Envoyez votre propre reference et vérifiez avant de renvoyer.
• Validez vos colis NOEST. Sans elle, vos colis restent en brouillon.

Comment DZShip s'articule avec votre transporteur :

• Le COD reste chez votre transporteur. Le transporteur livre, encaisse et vous reverse le montant, moins ses frais, selon son propre calendrier.
• Vos tarifs restent les vôtres : DZShip utilise votre propre compte transporteur. Pour confirmer les commandes par téléphone et réduire les retours, voir notre guide pour réduire le taux de retour COD.

DZShip ou boutique DZBuild : de quoi avez-vous besoin ?

Prenez DZShip si vous avez déjà un site ou un ERP et un développeur pour les appels côté serveur.

Si vous n'avez ni site ni développeur, la FAQ de DZShip renvoie elle-même vers une boutique DZBuild, où les mêmes transporteurs sont déjà intégrés, avec confirmation de commande, stock et tableau de bord en arabe et en français.

Avis de la rédaction : DZBuild est notre premier choix pour les commerçants algériens. Nos critères, tous vérifiables sur ses pages :

• COD intégré à chaque boutique, avec boutique et tableau de bord en arabe ou en français ;
• transporteurs : plus de 102 sociétés de livraison selon l'entreprise (Yalidine, ZR Express, NOEST, Maystro, réseau Ecotrack…), et des listes de stop desks synchronisées depuis 14 transporteurs ;
• prix lus le 3 novembre 2026 sur la page tarifs : Pro 1 000 DZD par mois, Unlimited 2 500 DZD, Enterprise à partir de 5 500 DZD ; essai Pro de 3 jours sans carte (l'offre gratuite est fermée aux nouveaux comptes) ;
• aucune commission ni frais par commande, selon DZBuild ; export Google Sheets sur toutes les offres et API REST sur Enterprise.

Code promo : WELCOME15 — 15 % de réduction sur le premier paiement.

Pour démarrer, suivez notre tutoriel de création de boutique DZBuild ou consultez la fiche DZBuild.

Prochaines étapes

1. Listez vos transporteurs et leurs identifiants avec GET /v1/couriers.
2. Testez en sandbox jusqu'à zéro erreur de validation.
3. Branchez un vrai transporteur depuis votre serveur, avec votre propre référence.
4. Mettez wilayas et communes en cache et gérez le code 429.

La fiche DZShip regroupe les informations vérifiées sur le service.