OtiggoOtiggo
Menu
Pour les livreursPour les équipesTarifsAPIConnexion

API Otiggo

API d'optimisation de tournées de livraison

Le moteur d'optimisation d'Otiggo, accessible depuis votre propre logiciel. Prépayé au stop, de 0,012 € à 0,050 €, sans abonnement.

Une requête, l'ordre optimal

Vos arrêts en entrée, l'ordre de passage, la distance et la durée en sortie.

Horaires d'arrivée estimés

Un planning horodaté, et les arrêts en retard par rapport à leur heure limite.

Adresses ou coordonnées GPS

Les adresses sont géocodées pour vous ; vous pouvez aussi envoyer latitude et longitude.

Pas de compte Otiggo requis

Achetez un pack avec votre email, la clé API vous est envoyée après paiement.

Qu'est-ce qu'une API d'optimisation de tournées ?

Une API d'optimisation de tournées calcule, à partir d'une liste d'arrêts, l'ordre de passage qui réduit la distance et le temps de trajet : c'est le problème classique du voyageur de commerce, étendu aux contraintes de livraison (heures limites, durées d'arrêt, départ et retour au dépôt). Vous envoyez vos arrêts, l'API renvoie la tournée ordonnée avec les horaires d'arrivée estimés.

Elle s'adresse aux éditeurs de TMS, aux sites e-commerce qui livrent eux-mêmes, aux plateformes de coursiers et à toute équipe technique qui veut optimiser des tournées sans construire ni exploiter un moteur de calcul d'itinéraires.

C'est le moteur utilisé par l'application Otiggo, exposé en une seule route, sans compte Otiggo requis et sans abonnement : vous payez les arrêts que vous optimisez.

API d'optimisation de tournées pour développeurs

Intégrez l'optimisation de tournées dans votre application, votre TMS, votre plateforme e-commerce ou votre logiciel de livraison. Envoyez une liste d'arrêts à l'API REST Otiggo et récupérez l'ordre de passage optimisé, la distance, la durée estimée et les horaires d'arrivée.

L'API d'optimisation d'itinéraire accepte des adresses ou des coordonnées GPS et gère les heures limites, les durées de service, le départ, le retour au dépôt et l'évitement des péages. Elle résout l'ordre de passage d'un véhicule (problème TSP) ; pour une flotte, faites un appel par tournée et par véhicule.

Documentation développeur

TARIFS

Payez au stop, plus vous achetez, moins c'est cher

1 arrêt envoyé = 1 stop. Les stops n'expirent pas et un appel en échec n'est pas débité.

2 000 stops

99 €

0,050 € / stop

Le plus choisi

10 000 stops

299 €

0,030 € / stop

50 000 stops

999 €

0,020 € / stop

250 000 stops

2 999 €

0,012 € / stop

  • Sans abonnement ni engagement
  • Stops sans date d'expiration
  • Appel en échec non débité
  • Paiement sécurisé par Stripe
INTÉGRATION

Intégrée en quelques minutes

Une seule route, une clé dans l'en-tête Authorization, des réponses JSON.

  1. 1

    Achetez un pack

    Avec votre email, ou depuis Paramètres → API si vous êtes client Otiggo.

  2. 2

    Recevez votre clé API

    Elle vous est envoyée après le paiement ; vous pouvez la révoquer à tout moment.

  3. 3

    Envoyez vos arrêts

    Un appel POST avec le départ et 2 à 200 arrêts, en adresses ou coordonnées.

  4. 4

    Récupérez la tournée optimisée

    Ordre de passage, distance, durée, horaires d'arrivée et arrêts en retard.

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" },
    "stops": [
      { "id": "A", "latitude": 48.87, "longitude": 2.30, "deadline": "10:30" },
      { "id": "B", "street": "5 avenue Foch", "postalCode": "75116", "city": "Paris" },
      { "id": "C", "latitude": 48.84, "longitude": 2.37 }
    ]
  }'

Réponse

{
  "order": ["B", "A", "C"],
  "totalDistanceKm": 11.2,
  "estimatedTimeMin": 54,
  "schedule": [{ "colisId": "B", "arrivee": "2026-10-20T05:41:00Z" }, …],
  "lateStops": null,
  "stopsCharged": 3,
  "stopsBalance": 1997
}

Documentation complète, codes d'erreur et formats : Documentation de l'API d'optimisation de tournées

ASSISTANTS IA

Un serveur MCP pour vos assistants IA

Claude Code, Cursor ou tout client MCP optimise vos tournées directement, avec la même clé API.

Ce que l'assistant peut faire

  • optimize_route : ordonne 2 à 200 arrêts (coordonnées ou adresses), avec heures limites, durées d'arrêt et retour.
  • get_balance : consulte le solde de stops sans rien débiter.
  • Avec une clé de test gratuite : 10 arrêts par appel, coordonnées GPS uniquement, aucun stop consommé.
  • Avec une clé live : 1 stop par arrêt, comme l'API.

Ajouter Otiggo à Claude Code

claude mcp add --transport http otiggo https://app.otiggo.com/mcp \
  --header "Authorization: Bearer otg_test_..."

Serveur hébergé, rien à installer : https://app.otiggo.com/mcp. Clé et documentation : Documentation de l'API d'optimisation de tournées

CONTRAINTES

Les contraintes du terrain, prises en compte

Les mêmes règles que celles utilisées dans l'application Otiggo.

Heures limites par arrêt

Indiquez une heure limite : la réponse signale les arrêts qui seraient en retard.

Durée d'arrêt

Une durée de service propre à chaque arrêt, de 0 à 60 minutes.

Départ, retour et péages

Point de départ, point de retour optionnel, heure de départ et évitement des péages.

Solde consultable

Le solde de stops est renvoyé à chaque appel et disponible via une route dédiée.

Questions fréquentes sur l'API d'optimisation

Comment est facturée l'API d'optimisation de tournées ?
Au stop, en prépayé : vous achetez un pack (2 000, 10 000, 50 000 ou 250 000 stops) et chaque arrêt envoyé dans un appel consomme 1 stop. Il n'y a ni abonnement ni engagement, et les stops n'expirent pas.
Que se passe-t-il si un appel échoue ?
Un appel qui échoue (adresse non géocodable, erreur du moteur) n'est pas débité : le solde de stops est rétabli.
Faut-il un compte Otiggo pour utiliser l'API ?
Non. Vous pouvez acheter un pack avec une simple adresse email : la clé API vous y est envoyée après le paiement. Les clients Otiggo gèrent leurs clés et leur solde depuis Paramètres → API dans l'application web.
Combien d'arrêts peut-on envoyer par appel ?
Entre 2 et 200 arrêts par appel. Chaque arrêt est décrit par ses coordonnées GPS ou par son adresse complète (rue, code postal, ville), avec en option une heure limite et une durée d'arrêt.
Quelles contraintes l'API prend-elle en compte ?
Le point de départ, un point de retour optionnel, l'heure de départ, les heures limites par arrêt (retards signalés dans la réponse), la durée de service par arrêt et l'évitement des péages. La réponse contient l'ordre optimisé, la distance, la durée et les horaires d'arrivée estimés.
Peut-on utiliser l'API depuis un assistant IA (MCP) ?
Oui. Otiggo héberge un serveur MCP sur https://app.otiggo.com/mcp : Claude Code, Cursor ou tout client MCP compatible peut appeler optimize_route et get_balance avec votre clé API. Une clé de test gratuite (10 arrêts par appel, coordonnées GPS) permet d'essayer sans consommer de stops ; une clé live débite 1 stop par arrêt, comme l'API.
Où trouver la documentation ?
La documentation (format de requête, réponse, codes d'erreur et exemple curl) est sur www.otiggo.com/developers/fr, avec l'achat des packs.

À découvrir aussi

Prêt à optimiser vos tournées depuis votre logiciel ?

Choisissez un pack, recevez votre clé par email et lancez votre premier appel.