API développeur
L’API développeur de TourPro permet à vos propres scripts et intégrations de lire vos données. L’accès repose sur des jetons d’accès personnels : chaque jeton agit en votre nom et ne voit que les tournées auxquelles vous avez accès.
La phase 1 est en lecture seule : vous pouvez récupérer votre identité, vos tournées et les événements du planning.
Créer un jeton
Ouvrir votre profil
Dans l’application web, ouvrez votre Profil et choisissez l’onglet Développeur.
Créer le jeton
Cliquez sur Créer un jeton, donnez-lui un nom explicite (par exemple le script ou le service qui l’utilisera), puis confirmez.
Le copier immédiatement
TourPro n’affiche le jeton qu’une seule fois. Copiez-le et conservez-le comme un mot de passe. Si vous le perdez, révoquez ce jeton et créez-en un nouveau.
Appeler l’API
Transmettez le jeton comme identifiant Bearer dans l’en-tête HTTP :
Authorization: Bearer tourpro_...| Point d’entrée | Données renvoyées |
|---|---|
GET /api/v1/me | Votre identifiant utilisateur, votre nom et votre e-mail |
GET /api/v1/tours | Les tournées auxquelles vous avez accès |
GET /api/v1/tours/:tourId/events | Les événements du planning d’une tournée, filtrés selon vos autorisations et règles de visibilité |
L’URL de base correspond à l’hôte de l’API (par exemple https://api.tourpro.app), et non à l’application web.
curl https://api.tourpro.app/api/v1/tours \
-H "Authorization: Bearer tourpro_..."L’API est limitée à 120 requêtes par minute et par jeton. Au-delà de ce seuil, vous recevez une réponse 429 accompagnée des en-têtes RateLimit détaillant la fenêtre en cours.
Révoquer un jeton
De retour dans l’onglet Développeur, cliquez sur Révoquer en face d’un jeton puis confirmez. La révocation est immédiate et irréversible : créez un nouveau jeton si vous avez besoin d’un remplacement.
Ce qu’un jeton peut voir
Un jeton ne voit jamais plus que vous :
- Tournées : uniquement les tournées que vous avez créées ou auxquelles vous appartenez.
- Événements : uniquement les événements visibles pour votre rôle et vos dates sur cette tournée, et seulement si vous disposez de l’autorisation de voir le planning.
- Tout est en lecture seule. Aucun appel à l’API ne peut modifier vos données.
Les sessions de connexion issues de l’application ne fonctionnent pas sur l’API. Les points d’entrée v1 acceptent exclusivement les jetons préfixés par tourpro_, de sorte qu’une session navigateur compromise ne peut pas être rejouée contre l’API.