Démarrage rapide

Trois étapes pour votre première tournée optimisée.

1. Obtenir une clé API

Sandbox (gratuit) — créez une clé de test dans la console. Préfixe : otg_test_…
Production — achetez un pack et recevez une clé live par email. Préfixe : otg_live_…

2. Envoyer une requête

Authentifiez-vous avec Authorization: Bearer <clé>. Fournissez au minimum start et 2 arrêts.

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" }
  ]
}'

3. Lire la réponse

Vous obtenez l'ordre optimal, les waypoints, distance, durée, et un planning avec horaires d'arrivée.

200 · live

{
  "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
}

200 · sandbox