Documentation technique


Contexte

Le Registre de Disponibilité des Taxis est un Point d'Echange de Taxis (ou TXP : Taxi Exchange Point) dont la finalité est de faciliter la mise en relation des taxis et leurs clients. Les clients peuvent utiliser des Moteurs de recherche de Taxis pour héler des taxis géolocalisés par des Opérateurs de Taxis.

Le Registre de Disponibilité des Taxis sert d'intermédiaire entre les Moteurs de recherche de Taxis et les Opérateurs de Taxis.

Implémentation

La présente documentation donne un aperçu des APIs REST du Registre de Disponibilité des Taxis. Ces APIs REST fournissent un accès aux ressources du registre (data entities) via des Identifiants Uniformes de Ressources (ou URI : Uniform Resource Identifier). Pour utiliser ces APIs REST, votre application fait une requète HTTPS et analyse la réponse reçue. Les méthodes utilisées sont les méthodes HTTP standard comme GET , PUT et POST. Ces APIs REST opèrent sur HTTPS, ce qui permet de les utiliser aisément depuis n'importe quel langage de programmation. Le format d'entrée et de sortie pour les APIs REST du Registre de Disponibilité des Taxis est JSON.

La documentation complètes des APIs REST du Registre de Disponibilité des Taxis est librement accessible ici : https://api.taxi/documentation.

Authentification

L'authentification de l'application accédant au Registre de Disponibilité des Taxis est faite lors de chaque requète en incluant une en-tête HTTP X-API-KEY.

Les clés d'API sont accessibles pour les développeurs accrédités ici : https://api.taxi/user_key.

Si vous souhaitez implémenter l'API du Registre de Disponibilité des Taxis, vous pouvez commencer par étudier la documentation, librement accessible, puis demandez une clé d'API en écrivant à l'adresse : apikey -[at]- le.taxi

Infrastructure

Les environnements des développement, recette et production sont les suivants :

Requètes HTTPS Géolocalisation UDP Documentation
DEV dev.api.taxi geoloc.dev.api.taxi Documentation
TEST test.api.taxi geoloc.test.api.taxi Documentation
PROD api.taxi geoloc.api.taxi Documentation

L'état des services peut être suivi en temps réel sur la page suivante : Etat des services.

Les anciens serveurs de développement (api[-dev].opendatataxi.fr et geoloc.opendatataxi.fr) seront maintenus quelques temps avant d'être décommissionés.