Premiers pas
Trois étapes : créez votre clé, identifiez-vous, lancez votre première requête. L'API est en lecture-écriture pour vos propres ressources uniquement.
1. Créez une clé API
Ouvrez l'application Mastro, allez dans l'onglet « Développeurs » et créez une nouvelle clé. La clé n'est affichée qu'une seule fois — copiez-la dans un coffre-fort de secrets.
- Format : mk_live_<keyId>.<secret>
- La clé donne accès aux données du compte qui l'a créée — DRIVER ou CONTRACTOR — et rien d'autre.
- Pas de mode sandbox en v1 : utilisez l'API en production avec parcimonie.
2. Configurez votre client
Tous les endpoints publics vivent sous /v1 sur api.mastro.app. Ajoutez la clé en en-tête Authorization à chaque requête.
- URL de base
https://api.mastro.app - Version
v1 - En-tête
Authorization: Bearer mk_live_<keyId>.<secret>
3. Lancez une requête
Le moyen le plus rapide de valider votre clé : un appel POST /v1/quotes. Pas de course créée, pas d'effet de bord — juste un calcul de prix.
curl -X POST https://api.mastro.app/v1/quotes \
-H "Authorization: Bearer mk_live_<keyId>.<secret>" \
-H "Content-Type: application/json" \
-d '{
"pickup": "10 rue de Rivoli, 75004 Paris",
"dropoff": "Aéroport CDG, 95700 Roissy",
"serviceTierId": "65a1f3e7c8b1d2e3f4a5b6c7"
}'