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": {
    "address": "<string>",
    "date": "2023-11-07T05:31:56Z",
    "start_time": "<string>",
    "end_time": "<string>",
    "need_appointment": false,
    "contact": {
      "name": "<string>",
      "phone": "<string>",
      "mail": "jsmith@example.com"
    }
  },
  "delivery": {
    "address": "<string>",
    "date": "2023-11-07T05:31:56Z",
    "start_time": "<string>",
    "end_time": "<string>",
    "need_appointment": false,
    "contact": {
      "name": "<string>",
      "phone": "<string>",
      "mail": "jsmith@example.com"
    }
  },
  "billing": {
    "company_name": "<string>",
    "email": "<string>",
    "address": "<string>",
    "siret": "<string>"
  },
  "type": "<string>",
  "vehicle": {
    "type": "<string>",
    "registration": "<string>",
    "vin": "<string>",
    "brand": "<string>",
    "model": "<string>",
    "electric": false
  },
  "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. address en texte libre géocodé serveur (le plus précis possible) ; l'adresse RÉSOLUE est renvoyée dans la réponse.

delivery
object
requis

Point de livraison (voir pickup).

billing
object
requis

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

type
string

Type de transport.

vehicle
object

Caractéristiques du véhicule (alias car).

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, jamais un point de départ. Formes acceptées : true = A→B→A (retour au point d'enlèvement) ; une chaîne = A→B→C (adresse de destination) ; un objet = forme complète (delivery, car, contacts…). En forme courte (true/chaîne), véhicule et contacts du retour héritent de l'aller.

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.