Console Acheter

POST/api/v1/optimize

Optimiser une tournée

Calcule l'ordre optimal des arrêts avec horaires d'arrivée, distance et durée.

https://app.otiggo.com/api/v1/optimize

Facturation

1 crédit stop par arrêt de la requête (pas au kilomètre)
2–200 arrêts par appel en production
Les optimisations en échec sont remboursées automatiquement

Corps de la requête

Param	Type	Description
`start`required	Location	Point de départ. Coordonnées ou street + postalCode + city.
`end`optional	Location	Point de retour optionnel. Même forme que start.
`stops`required	Stop[]	Tableau d'arrêts (2–200). Chaque arrêt a un id unique et un lieu.
`departureTime`optional	string (ISO 8601)	Date/heure de départ optionnelle pour le planning.
`avoidTolls`optional	boolean	Si true, privilégie les itinéraires sans péage.

Location

Soit des coordonnées, soit une adresse complète (géocodée côté serveur — clés live uniquement).

Param	Type	Description
`latitude`optional	number	−90 … 90
`longitude`optional	number	−180 … 180
`street`optional	string	Adresse / rue
`postalCode`optional	string	Code postal
`city`optional	string	Ville

Stop

Param	Type	Description
`id`required	string	Identifiant unique (100 caractères max). Renvoyé dans order et schedule.
`deadline`optional	string	Délai optionnel « HH:MM » en heure Europe/Paris.
`serviceSeconds`optional	number	Temps passé à l'arrêt (0–3600), optionnel.

Champs de réponse

Param	Type	Description
`order`optional	string[]	Ids des arrêts dans l'ordre de visite optimal.
`waypoints`optional	object[]	id, order, latitude, longitude pour chaque arrêt.
`totalDistanceKm`optional	number	Distance totale de la tournée.
`estimatedTimeMin`optional	number	Durée estimée en minutes.
`schedule`optional	object[]	Horaires d'arrivée (colisId, arrivee).
`departAt / returnAt`optional	string \| null	Départ et retour au format ISO.
`lateStops`optional	object[] \| null	Arrêts en retard sur leur deadline, le cas échéant.
`stopsCharged`optional	number	Crédits débités (0 en sandbox).
`stopsBalance`optional	number	Solde restant (live uniquement).

Requête

curl https://app.otiggo.com/api/v1/optimize \
  -H "Authorization: Bearer otg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "start": { "street": "12 rue de la Paix", "postalCode": "75002", "city": "Paris" },
  "end": { "latitude": 48.8566, "longitude": 2.3522 },
  "departureTime": "2026-10-20T07:30:00+02:00",
  "avoidTolls": true,
  "stops": [
    { "id": "A", "latitude": 48.87, "longitude": 2.30, "deadline": "10:30", "serviceSeconds": 120 },
    { "id": "B", "street": "5 avenue Foch", "postalCode": "75116", "city": "Paris" }
  ]
}'

Réponse

200

{
  "order": ["B", "A"],
  "waypoints": [
    { "id": "B", "order": 1, "latitude": 48.8738, "longitude": 2.2950 },
    { "id": "A", "order": 2, "latitude": 48.8700, "longitude": 2.3000 }
  ],
  "totalDistanceKm": 7.4,
  "estimatedTimeMin": 38,
  "schedule": [
    { "colisId": "B", "arrivee": "2026-10-20T05:41:00Z" },
    { "colisId": "A", "arrivee": "2026-10-20T05:55:00Z" }
  ],
  "departAt": "2026-10-20T05:30:00Z",
  "returnAt": "2026-10-20T06:08:00Z",
  "lateStops": null,
  "stopsCharged": 2,
  "stopsBalance": 1998
}

PrécédentAuthentification SuivantSolde