Démarrage rapide

L’API Transport vous permet de créer, tarifer et suivre des missions de transport de véhicules par programmation, et de recevoir les événements de chaque mission en temps réel via des webhooks signés. Ce guide vous fait passer de zéro à une mission suivie en quatre étapes : obtenir une clé, estimer un prix, créer une mission, puis la suivre.

Base URL : https://api.myexpressdriver.com/v1Toutes les requêtes exigent l’en-tête X-Api-Key. Les réponses de succès sont en application/json ; les erreurs suivent la RFC 9457 (application/problem+json).

Avant de commencer

Un compte client MED

Flotte, concession ou loueur. Votre clé API est rattachée à votre groupe : elle ne voit que les missions de ce groupe.

Un accès admin de groupe

Seul l’administrateur du groupe peut créer ou révoquer des clés API depuis la console.

Démarrage en 4 étapes

Obtenir une clé API

Les clés API se créent depuis la console client, onglet API & Intégrations. Cet onglet n’est visible que si vous êtes administrateur d’au moins un groupe.

Connectez-vous à votre console client.
Ouvrez l’onglet API & Intégrations (si plusieurs groupes, sélectionnez celui pour lequel vous voulez une clé).
Cliquez sur Créer une clé, donnez-lui un libellé (ex. intégration ERP) et choisissez l’environnement (live ou test).
Copiez la clé affichée et stockez-la dans un coffre de secrets.

La clé en clair n’est affichée qu’une seule fois, au moment de sa création. Elle n’est jamais ré-affichée ensuite. Si vous la perdez, révoquez-la et créez-en une nouvelle.

Les clés de production commencent par med_live_, les clés de test par med_test_. Chaque requête doit porter l’en-tête :

X-Api-Key: med_live_a1b2c3d4e5f6...

Exportez votre clé et la base URL dans des variables d’environnement pour les exemples ci-dessous :

export BASE="https://api.myexpressdriver.com/v1"
export MED_API_KEY="med_live_xxxxxxxxxxxxxxxxxxxx"

Estimer un prix

POST /pricing calcule un tarif à partir de la grille de votre groupe, sans créer de mission. Idéal pour afficher un devis avant de confirmer.

curl -s -X POST "$BASE/pricing" \
  -H "X-Api-Key: $MED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup":   { "address": "10 Rue de Rivoli, 75004 Paris" },
    "delivery": { "address": "1 Place Bellecour, 69002 Lyon" },
    "vehicle":  { "type": "VP", "electric": false },
    "plateau":  false,
    "options":  []
  }'

// Node.js >= 18 (fetch natif)
const BASE = "https://api.myexpressdriver.com/v1";
const MED_API_KEY = process.env.MED_API_KEY;

const res = await fetch(`${BASE}/pricing`, {
  method: "POST",
  headers: {
    "X-Api-Key": MED_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    pickup: { address: "10 Rue de Rivoli, 75004 Paris" },
    delivery: { address: "1 Place Bellecour, 69002 Lyon" },
    vehicle: { type: "VP", electric: false },
    plateau: false,
    options: [],
  }),
});

const pricing = await res.json();
console.log(pricing);

Réponse 200 — l’estimation tarifaire de votre groupe :

{
  "price_ht": 180.5,
  "currency": "EUR",
  "distance_km": 465,
  "return_trip": null
}

number

Prix HT du transport facturé au client.

string

Devise des montants — toujours EUR.

number

Distance estimée en kilomètres.

object | null

Détail du trajet retour si demandé (price_ht, distance_km), sinon null.

Créer une mission

POST /transports crée la mission. Sont requis : le véhicule avec son immatriculation, pickup et delivery (adresse, date au format YYYY-MM-DDTHH:MM:SS.sssZ, créneau et contact complet : nom, téléphone, e-mail) et billing (raison sociale, adresse, e-mail). Ajoutez l’en-tête Idempotency-Key (un UUID que vous générez) pour rendre la création rejouable sans risque de doublon.

IDEM=$(uuidgen)

curl -s -X POST "$BASE/transports" \
  -H "X-Api-Key: $MED_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEM" \
  -d '{
    "vehicle": {
      "type": "VP",
      "registration": "AB-123-CD",
      "brand": "Renault",
      "model": "Clio"
    },
    "pickup": {
      "address": "10 Rue de Rivoli, 75004 Paris",
      "date": "2026-11-03T00:00:00.000Z",
      "start_time": "08:00",
      "end_time": "12:00",
      "contact": { "name": "Jean Dupont", "phone": "+33600000000", "mail": "jean.dupont@garage-demo.fr" }
    },
    "delivery": {
      "address": "1 Place Bellecour, 69002 Lyon",
      "date": "2026-11-03T00:00:00.000Z",
      "start_time": "14:00",
      "end_time": "18:00",
      "contact": { "name": "Marie Martin", "phone": "+33611111111", "mail": "marie.martin@concession-lyon.fr" }
    },
    "billing": {
      "company_name": "Garage Demo SARL",
      "email": "compta@garage-demo.fr",
      "address": "5 Avenue des Champs, 75008 Paris",
      "siret": "12345678901234"
    },
    "options": [],
    "plateau": false
  }'

import { randomUUID } from "node:crypto";

const BASE = "https://api.myexpressdriver.com/v1";
const MED_API_KEY = process.env.MED_API_KEY;

const res = await fetch(`${BASE}/transports`, {
  method: "POST",
  headers: {
    "X-Api-Key": MED_API_KEY,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    vehicle: {
      type: "VP",
      registration: "AB-123-CD",
      brand: "Renault",
      model: "Clio",
    },
    pickup: {
      address: "10 Rue de Rivoli, 75004 Paris",
      date: "2026-11-03T00:00:00.000Z",
      start_time: "08:00",
      end_time: "12:00",
      contact: { name: "Jean Dupont", phone: "+33600000000", mail: "jean.dupont@garage-demo.fr" },
    },
    delivery: {
      address: "1 Place Bellecour, 69002 Lyon",
      date: "2026-11-03T00:00:00.000Z",
      start_time: "14:00",
      end_time: "18:00",
      contact: { name: "Marie Martin", phone: "+33611111111", mail: "marie.martin@concession-lyon.fr" },
    },
    billing: {
      company_name: "Garage Demo SARL",
      email: "compta@garage-demo.fr",
      address: "5 Avenue des Champs, 75008 Paris",
      siret: "12345678901234",
    },
    options: [],
    plateau: false,
  }),
});

const transport = await res.json();
console.log(transport.id, transport.status); // -O9xAbCdEf scheduled

Réponse 201 — la mission est créée et planifiée :

{
  "id": "-O9xAbCdEf",
  "transport_id": null,
  "status": "scheduled",
  "price": "407.44"
}

string

Identifiant de la mission (offer_id). À conserver : il sert à toutes les requêtes de suivi.

string | null

Référence métier lisible de la mission (ex. M-54321). Vaut null dans la réponse de création : elle est attribuée juste après, lisez-la via GET /transports/{id}.

string

Statut public à la création : toujours scheduled (planifiée, en attente d’attribution).

string | null

Prix HT de l’aller, en chaîne décimale (ex. "407.44"). Le prix détaillé (amount_ht, surcharge_ht, currency) se lit via GET /transports/{id}.

Rejouer la même Idempotency-Key avec un corps identique renvoie la réponse mise en cache (en-tête Idempotent-Replayed: true) — une seule mission est créée. La même clé avec un corps différent renvoie 409 Conflict.

Suivre la mission

Deux moyens complémentaires de suivre une mission : interroger son détail à la demande, et s’abonner aux webhooks pour être notifié à chaque changement.Lire le détail à la demande avec GET /transports/{id} :

TID="-O9xAbCdEf"

# Détail complet
curl -s -H "X-Api-Key: $MED_API_KEY" "$BASE/transports/$TID"

# Statut public seul
curl -s -H "X-Api-Key: $MED_API_KEY" "$BASE/transports/$TID" \
  | grep -o '"status":"[^"]*"'

const BASE = "https://api.myexpressdriver.com/v1";
const MED_API_KEY = process.env.MED_API_KEY;
const TID = "-O9xAbCdEf";

const res = await fetch(`${BASE}/transports/${TID}`, {
  headers: { "X-Api-Key": MED_API_KEY },
});

const transport = await res.json();
console.log(transport.status); // scheduled | assigned | in_transit | ...

Le status évolue selon le cycle de vie public :

Statut	Sens
`scheduled`	Mission planifiée, en attente d’attribution.
`assigned`	Convoyeur attribué, pas encore enlevée.
`in_transit`	Véhicule enlevé, en route.
`in_transit_return`	Retour en cours (aller-retour).
`awaiting_documents`	En attente des PV / documents.
`under_review`	Documents en validation.
`completed`	Mission terminée.
`incident`	Anomalie signalée.
`cancelled`	Mission annulée.

S’abonner aux webhooks depuis l’onglet API & Intégrations : ajoutez un endpoint HTTPS et recevez un événement à chaque transition. Le corps a la forme { id, type, created_at, data } :

{
  "id": "8f2c1a9e-0b6d-4f2a-9c1e-2a3b4c5d6e7f",
  "type": "transport.status_changed",
  "created_at": "2026-07-01T10:32:00Z",
  "data": { "id": "-O9xAbCdEf", "from": "scheduled", "to": "assigned" }
}

Vérifiez toujours la signature X-MED-Signature (HMAC-SHA256) de chaque webhook avant de traiter son contenu, et dédupliquez sur X-MED-Delivery-Id. La procédure complète est détaillée dans le guide Webhooks.

Les webhooks sont livrés en at-least-once. Pour rattraper un événement manqué (endpoint indisponible), rejouez le journal avec GET /events?since=<ISO8601>.

Bien démarrer

Vous avez créé une clé, estimé un prix, créé une mission et lu son statut. Voici les réflexes à adopter pour une intégration robuste.

Sécuriser votre clé API

Stockez la clé dans un coffre de secrets, jamais en clair dans le code ni dans un dépôt. Une clé manquante, inconnue, révoquée ou expirée renvoie 401. En cas de fuite, révoquez-la depuis la console et créez-en une nouvelle.

Gérer les erreurs proprement

Branchez votre logique sur le champ status (et title) de la réponse application/problem+json, pas sur le texte de detail qui peut évoluer. Les erreurs de validation détaillent le champ fautif dans errors[].

Respecter les limites de débit

Un dépassement renvoie 429 Too Many Requests avec un en-tête Retry-After (en secondes). Implémentez un back-off et respectez ce délai.

Toujours utiliser l'idempotence

Ajoutez une Idempotency-Key unique sur toutes les créations et mutations (POST, PATCH, DELETE). C’est indispensable sur un réseau peu fiable pour éviter les doublons.

Étapes suivantes

Authentification

Clés live / test, scopes transports:read / transports:write et isolation par groupe.

Webhooks

Vérifier la signature HMAC, dédupliquer les livraisons et réconcilier les événements manqués.

Référence API

Tous les endpoints, schémas et codes de réponse en détail.

Démarrage

Concepts fondamentaux

Guides

Webhooks

Avant de commencer

Un compte client MED

Un accès admin de groupe

Démarrage en 4 étapes

Bien démarrer

Étapes suivantes

Authentification

Webhooks

Référence API

​Avant de commencer

Un compte client MED

Un accès admin de groupe

​Démarrage en 4 étapes

​Bien démarrer

​Étapes suivantes

Authentification

Webhooks

Référence API

Avant de commencer

Démarrage en 4 étapes

Bien démarrer

Étapes suivantes