Développeurs

Ouverts aux demandes

L'API grandit sur des cas réels. S'il vous manque quelque chose, une donnée de plus, un événement, une écriture depuis votre système, écrivez-nous : nous attendons des demandes précises et restons ouverts et disponibles pour les construire ensemble. support@dronetrake.com

Spécification

La spécification OpenAPI 3.1 est publique et mise à jour à chaque version : https://dronetrake.com/api/v1/openapi.yaml

GET https://dronetrake.com/api/v1/organization · GET /api/v1/school/students · GET /api/v1/school/tasks · GET /api/v1/school/tasks/{id} · GET /api/v1/school/attestations · GET /api/v1/missions · GET /api/v1/missions/{id} · GET /api/v1/flights

Authentification

Chaque requête porte un jeton dans l'en-tête Authorization: Bearer. Les jetons se créent dans le panneau, sous Business → API et intégrations ; ils appartiennent à une organisation et ont des portées explicites.

curl -H "Authorization: Bearer dt_xxxxxxxx_…" https://dronetrake.com/api/v1/organization

Portées

• organization.read — Organisation (lecture)
• school.read — Programme Écoles : élèves, tâches, attestations (lecture)
• operations.read — Opérations : missions et vols avec les heures par personne (lecture)

Limites

120 requêtes par minute et par jeton. Au-delà, 429 avec Retry-After.

Erreurs

Toujours en JSON : {"error": {"code", "message"}}. 401 jeton absent ou invalide, 403 portée insuffisante ou programme inactif, 404 introuvable, 429 trop de requêtes.

Webhooks

Enregistrez un endpoint https dans le panneau (Business → Webhooks) et choisissez les événements. Chaque livraison est un POST JSON avec les en-têtes X-Dronetrake-Event, X-Dronetrake-Delivery (identifiant unique) et X-Dronetrake-Signature (t=<unix>,v1=HMAC-SHA256 du corps préfixé par t.). Répondez 2xx sous 10 secondes ; sinon nous réessayons après 1 minute, 5, 30, 2 heures et 12 heures, puis la livraison est abandonnée et visible dans le journal. Trente échecs d'affilée éteignent l'endpoint.

• school.task.accepted — Tâche acceptée par l'élève
• school.task.declined — Tâche refusée
• school.task.revoked — Tâche révoquée par l'école
• school.task.completed — Tâche terminée
• school.task.attested — Attestation délivrée
• school.student.enrolled — Élève inscrit
• school.student.left — Élève parti
• mission.completed — Mission terminée
• flight.logged — Vol enregistré dans le carnet

POST https://esempio.scuola.it/dronetrake
X-Dronetrake-Event: school.task.attested
X-Dronetrake-Delivery: 7f3c…-…
X-Dronetrake-Timestamp: 1788950000
X-Dronetrake-Signature: t=1788950000,v1=9c1e…

{"id":"7f3c…","event":"school.task.attested","created_at":"2026-09-08T12:00:00+00:00","organization":{"id":165,"name":"Dronetrake Academy"},"data":{"task":{…},"attestation":{…}}}

Preuve

Chaque requête est journalisée : qui a lu quoi, quand, avec quel résultat. La création et la révocation des jetons sont des actes dans la chaîne de preuve de l'organisation.

À venir

Webhooks signés sur les événements du programme Écoles et écriture sur demande. Écrivez-nous à support@dronetrake.com.