Aller au contenu principal

dzship — l'API de livraison gratuite pour l'Algérie (Yalidine, ZR Express, Maystro, NOEST, Ecotrack en une seule intégration)

· 4 minutes de lecture
DZBuild Team
DZBuild Team
We build the platform

Tout développeur qui a travaillé sur l'e-commerce algérien connaît cette douleur : chaque transporteur a sa propre API. Authentification différente, noms de champs différents, statuts en français, en arabe ou en simples chiffres — et une documentation qui va du lacunaire au faux. Intégrer un transporteur prend des jours ; en supporter cinq, c'est maintenir cinq intégrations fragiles pour toujours.

Aujourd'hui, nous réglons ce problème pour tout le monde. dzship est une API de livraison publique et gratuite pour l'Algérie — une seule forme de requête pour créer, suivre et tarifer des colis contre remboursement (COD) avec Yalidine, ZR Express, Maystro, NOEST et plus de 30 transporteurs sur la plateforme Ecotrack (DHD, Conexlog, MSM Go, World Express et d'autres).

Sans inscription. Sans clé API. Sans aucun coût.

Pourquoi c'est gratuit​

DZBuild fait circuler chaque jour de vraies commandes COD à travers les 58 wilayas, et notre plateforme parle déjà à plus de 80 intégrations de livraison. dzship met ce moteur d'expédition éprouvé en production à la disposition de tous, parce que nous croyons que la tech algérienne grandit quand l'infrastructure ennuyeuse et douloureuse devient un problème résolu — pour tout le monde, pas seulement pour nos marchands.

Un écosystème de développeurs plus fort, c'est plus de boutiques en ligne, plus d'outils, plus de business qui passe au numérique. C'est la mission : faire passer la tech algérienne au niveau supérieur et rendre la vie des entrepreneurs plus simple. La livraison, c'est notre contribution au bien commun.

Une requête, n'importe quel transporteur​

Vous envoyez les identifiants de votre propre compte transporteur avec chaque appel — ils ne sont jamais stockés — et dzship traduit vers le dialecte que parle ce transporteur :

curl -X POST https://freeship.dzbuild.com/v1/orders \
  -H 'Content-Type: application/json' -d '{
    "courier":     "yalidine",
    "credentials": { "apiId": "YOUR_ID", "apiToken": "YOUR_TOKEN" },
    "order": {
      "recipient": {
        "fullName":    "Amine Bouzid",
        "phone":       "0551234567",
        "wilayaCode":  16,
        "communeName": "Bab Ezzouar"
      },
      "deliveryType": "home",
      "productList":  "Sneakers Air x1",
      "codAmount":    4500
    }
  }'
# → 201 { "trackingNumber": "yal-ABC123", "status": "created" }

Changer de transporteur = changer la clé courier et les identifiants. Le reste de votre code ne bouge pas. Le suivi fonctionne de la même façon et renvoie un vocabulaire de statuts canonique pour tous les transporteurs (picked_up, in_transit, out_for_delivery, delivered…) : votre tableau de bord n'aura plus jamais à interpréter « Sorti en livraison ».

Des clients prêts à l'emploi pour votre stack​

Vous n'avez même pas besoin d'écrire les appels HTTP. Le dépôt GitHub de dzship fournit des clients sous licence MIT :

  • Node.js — npm install dzship (sur npm) : zéro dépendance, types TypeScript inclus.

    import dzship from 'dzship';

    const client = dzship({
      courier: 'yalidine',
      credentials: { apiId: process.env.YAL_ID, apiToken: process.env.YAL_TOKEN },
    });
    const { trackingNumber } = await client.createOrder({ /* … */ });

  • PHP — une classe en un seul fichier qui tourne sur n'importe quel hébergement mutualisé (recettes Laravel et WooCommerce incluses).

  • Python — un module en un seul fichier, bibliothèque standard uniquement, pour Django, Flask, FastAPI ou un simple script.

  • Google Sheets — un snippet Apps Script pour le classique « 200 commandes dans un tableur ».

Le guide d'intégration couvre tous les chemins, et le dépôt contient aussi des guides de terrain pour chaque transporteur — les pièges que nous avons appris à nos dépens, documentés pour que vous n'ayez pas à les redécouvrir.

Un dataset gratuit en plus : toutes les wilayas et communes​

De mauvaises données d'adresse tuent les livraisons. Le dépôt inclut un dataset dans le domaine public (CC0) des 58 wilayas et 1 541 communes — noms français et arabes, découpage actuel post-2021, en JSON et CSV. Utilisez-le dans vos formulaires de commande, aucune attribution requise :

const wilayas = await fetch(
  'https://raw.githubusercontent.com/DZBuild-com/dzship/main/data/wilayas.json'
).then((r) => r.json());

Usage équitable, disponible partout​

dzship est disponible dans le monde entier, protégé par des limites d'usage équitable (30 commandes/heure par IP, quotas de suivi généreux) pour rester rapide et gratuit pour tous. Référence complète, codes d'erreur et limites : freeship.dzbuild.com.

Une seule règle de sécurité : appelez l'API depuis votre serveur, jamais depuis un navigateur ou une application mobile — vos identifiants transporteur doivent rester secrets.

Quand il vous faut plus que la livraison​

dzship, c'est la couche livraison. Si vous construisez une boutique complète pour un marchand algérien, DZBuild c'est tout le reste : vitrines en arabe et en français, landing pages, gestion des commandes COD avec workflows de confirmation, 80+ transporteurs pré-intégrés, stock et analytics — en ligne en quelques minutes, sans code.

Dans les deux cas, lancez quelque chose. C'est ça, l'idée.

Commencez ici : freeship.dzbuild.com · github.com/DZBuild-com/dzship · npm install dzship