Bienvenue sur la documentation de l'API le.taxi.

L'API le.taxi permet aux clients d'utiliser une application de mobilité partenaire afin de héler un artisan taxi disponible situé à proximité.

Notre documentation est organisée en quatre sections :

  • Les tutoriels expliquent étape par étape comment créer une application compatible avec le.taxi.
  • Les guides thématiques abordent des sujets clés et fournissent des explications de base utiles.
  • Les guides de référence contiennent la documentation technique de l'API. Elles supposent que vous avez une compréhension préalable du fonctionnement général de l'API.
  • Les guides pratiques sont des recettes que vous pouvez appliquer pour résoudre les problèmes que vous pourriez rencontrer en utilisant l'API. Ils supposent que vous avez une compréhension préalable du fonctionnement de l'API.
Intégration¶

Nous mettons à disposition un environnement de développement pour permettre de tester l'intégration de votre solution avec l'API. Cet environnement, disponible dans la section Intégration de la console de développement, nécessite d'être authentifié. La création de compte se fait après validation de votre dossier.

Requêtes¶

Tous les appels à l'API doivent se faire avec les headers HTTP suivants :

Nom du headerValeur
X-Api-KeyClé d'API, disponible sur la page Mon Compte

Les requêtes de modifications (POST, PUT, PATCH) nécessitent de fournir le header suivant :

Nom du headerValeur
Content-Typeapplication/json

Toutes les réponses de l'API sont contenues dans le champ data de type liste à un élément. Par exemple :


$> curl 'https://dev.api.taxi/taxis/?lon=2.3500013351440434&lat=48.85999989664685' \
      -H 'X-Api-Key: XXX' | jq .
{
  "data": [
    {
      "id": "..."
    },
    ...
  ]
}

Si vous constatez un manque ou une erreur dans notre documentation, n'hésitez pas à contacter l'équipe sur votre canal Slack ou par email sur equipe@le.taxi.