Mettre à jour un trajet

PATCH /journeys/{operator_journey_id}
Token

Permet de mettre à jour un trajet qui est en erreur suite à un problème de validation sur le payload. Par exemple suite à un problème de validation sur les coordonnées géographiques envoyées

Path parameters

application/json

Body Required

  • operator_trip_id string

    Identifiant généré par l'opérateur pour regrouper des trajets (plusieurs passagers avec un même conducteur)

  • operator_class Required

    classe de preuve correspondant aux spécifications définies dans Classes de preuve de covoiturage.

    Values are A, B, or C.

  • incentives array[object] Required

    Tableau reprenant la liste complète des incitations appliquées (ordre d'application, montant, identifiant de l'incitateur). Si aucune incitation, envoyer un tableau vide.

    Ordre par défaut

    Par défaut, l'ordre d'application des politiques incitatives est le suivant :

    1. Territoire (AOM, Région, ...)
    2. Sponsors (incitations employeur, CE, etc.)
    3. Opérateur (opération promotionnelle, offres, etc.)
    Hide incentives attributes Show incentives attributes object
    • index number Required

      Ordre d'application de l'incitation

      Minimum value is 0.

    • amount number Required

      Montant de l'incitation en centimes d'euros

      Minimum value is 0.

    • siret string Required

      Numéro de SIRET de l'incitateur Le SIRET est un identifiant unique par structure juridique. Toutes les entités incitatrices en possèdent un.

  • start object Required

    Position lat/lon + date du passager

    Additional properties are NOT allowed.

    Hide start attributes Show start attributes object
    • datetime string(date-time) Required

      Date et heure du départ/arrivée du passager au format ISO 8601. L'heure est exprimée en UTC (YYYY-MM-DDThh:mm:ssZ) L'heure est exprimée en UTC (Coordinated Universal Time). UTC n'est pas ajusté sur l'heure d'été et hiver !

    • lat number Required

      Latitude comprise entre 90deg et -90deg décimaux en datum WSG-84

    • lon number Required

      Longitude comprise entre 180deg et -180deg décimaux en datum WSG-84

  • end object Required

    Position lat/lon + date du passager

    Additional properties are NOT allowed.

    Hide end attributes Show end attributes object
    • datetime string(date-time) Required

      Date et heure du départ/arrivée du passager au format ISO 8601. L'heure est exprimée en UTC (YYYY-MM-DDThh:mm:ssZ) L'heure est exprimée en UTC (Coordinated Universal Time). UTC n'est pas ajusté sur l'heure d'été et hiver !

    • lat number Required

      Latitude comprise entre 90deg et -90deg décimaux en datum WSG-84

    • lon number Required

      Longitude comprise entre 180deg et -180deg décimaux en datum WSG-84

  • distance number Required

    Distance exprimée en mètre

    Minimum value is 0, maximum value is 1000000.
PATCH /journeys/{operator_journey_id} 
curl \
 -X PATCH http://api.example.com/journeys/{operator_journey_id} \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"operator_trip_id":"string","operator_class":"A","incentives":[{"index":0,"amount":100,"siret":"11000101300017"}],"start":{"datetime":"2021-01-01T11:00:00Z","lat":47.682821,"lon":-0.557483},"end":{"datetime":"2021-01-01T11:00:00Z","lat":47.682821,"lon":-0.557483},"distance":42.0}'
Request examples 
{
  "operator_trip_id": "string",
  "operator_class": "A",
  "incentives": [
    {
      "index": 0,
      "amount": 100,
      "siret": "11000101300017"
    }
  ],
  "start": {
    "datetime": "2021-01-01T11:00:00Z",
    "lat": 47.682821,
    "lon": -0.557483
  },
  "end": {
    "datetime": "2021-01-01T11:00:00Z",
    "lat": 47.682821,
    "lon": -0.557483
  },
  "distance": 42.0
}