POST
/
transports
Créer une mission
curl --request POST \
  --url https://sandbox.myexpressdriver.com/v1/transports \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "pickup": {},
  "delivery": {},
  "billing": {
    "company_name": "<string>",
    "email": "<string>",
    "address": "<string>",
    "siret": "<string>"
  },
  "type": "<string>",
  "vehicle": {
    "type": "<string>",
    "registration": "<string>",
    "vin": "<string>",
    "brand": "<string>",
    "model": "<string>",
    "electric": true
  },
  "options": [
    "<string>"
  ],
  "description": "<string>",
  "return_trip": true,
  "plateau": true,
  "wgarage": true
}
'
{
  "id": "<string>",
  "transport_id": "<string>",
  "status": "scheduled",
  "price": {},
  "pickup": {
    "address": "<string>",
    "lat": 123,
    "lng": 123,
    "place_id": "<string>"
  },
  "delivery": {
    "address": "<string>",
    "lat": 123,
    "lng": 123,
    "place_id": "<string>"
  },
  "return_trip": {
    "pickup": {
      "address": "<string>",
      "lat": 123,
      "lng": 123,
      "place_id": "<string>"
    },
    "delivery": {
      "address": "<string>",
      "lat": 123,
      "lng": 123,
      "place_id": "<string>"
    }
  }
}

Autorisations

X-Api-Key
string
header
requis

Clé API liée à un groupe (med_live_… en production, med_test_… en test). Fournie en clair une seule fois à la création depuis le profil client.

En-têtes

Idempotency-Key
string

Clé d'idempotence fournie par le client. Rejouer la même clé avec un body identique renvoie la réponse en cache (Idempotent-Replayed: true). La même clé avec un body différent renvoie 409.

Corps

application/json

Requête de création d'une mission.

pickup
object
requis

Point d'enlèvement (adresse, date, horaires, contact). Le champ address est en texte libre, géocodé côté serveur : indiquez-le le plus précis possible (numéro + rue + code postal + ville) pour éviter toute ambiguïté de distance/prix. L'adresse RÉSOLUE est renvoyée dans la réponse (pickup) — vérifiez-la.

delivery
object
requis

Point de livraison (adresse, date, horaires, contact). address en texte libre, géocodé serveur (voir pickup). L'adresse RÉSOLUE est renvoyée dans la réponse (delivery).

billing
object
requis

Facturation simplifiée (company_name, email, address, siret?).

type
string

Type de transport.

vehicle
object

Caractéristiques du véhicule.

options
string[]
description
string
return_trip

Trajet retour (optionnel). Le départ du retour est AUTOMATIQUEMENT le lieu de LIVRAISON de l'aller (le convoyeur repart de là où il a livré) : ne renseignez donc QUE la destination du retour (return_trip.delivery), jamais un point de départ.

plateau
boolean
wgarage
boolean

Réponse

Mission créée.

id
string | null
requis

Identifiant de la mission (offer_id).

transport_id
string | null
requis
status
string
défaut:scheduled
requis
Exemple:

"scheduled"

price
object
requis
pickup
object
requis

Adresse d'enlèvement RÉSOLUE effectivement utilisée pour la mission.

delivery
object
requis

Adresse de livraison RÉSOLUE effectivement utilisée pour la mission.

return_trip
object
requis

Adresses résolues du retour si présent, sinon null.