Sviluppatori

Aperti alle richieste

L'API cresce sui casi veri. Se ti serve qualcosa che non c'è, un dato in più, un evento, una scrittura dal tuo sistema, scrivici: ci attendiamo richieste specifiche e restiamo aperti e disponibili a costruirle insieme. support@dronetrake.com

Specifica

La specifica OpenAPI 3.1 è pubblica e si aggiorna con ogni versione: 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

Autenticazione

Ogni richiesta porta un token nell'intestazione Authorization: Bearer. Il token si crea nel pannello, in Business → API e integrazioni, appartiene a un'organizzazione e ha ambiti espliciti.

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

Ambiti

• organization.read — Organizzazione (lettura)
• school.read — Programma Scuole: allievi, compiti, attestazioni (lettura)
• operations.read — Operazioni: missioni e voli con le ore per persona (lettura)

Limiti

120 richieste al minuto per token. Oltre, 429 con Retry-After.

Errori

Sempre JSON: {"error": {"code", "message"}}. 401 token mancante o non valido, 403 ambito insufficiente o programma non attivo, 404 non trovato, 429 troppe richieste.

Webhook

Registra un endpoint https nel pannello (Business → Webhook) e scegli gli eventi. Ogni consegna è un POST in JSON con le intestazioni X-Dronetrake-Event, X-Dronetrake-Delivery (id univoco) e X-Dronetrake-Signature (t=<unix>,v1=HMAC-SHA256 del corpo con prefisso t.). Rispondi 2xx entro 10 secondi; altrimenti ritentiamo dopo 1 minuto, 5, 30, 2 ore e 12 ore, poi la consegna è abbandonata e la vedi nel registro. Trenta fallimenti di fila spengono l'endpoint.

• school.task.accepted — Compito accettato dall'allievo
• school.task.declined — Compito rifiutato
• school.task.revoked — Compito revocato dalla scuola
• school.task.completed — Compito completato
• school.task.attested — Attestazione rilasciata
• school.student.enrolled — Allievo iscritto
• school.student.left — Allievo uscito
• mission.completed — Missione completata
• flight.logged — Volo registrato nel logbook

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":{…}}}

Evidenza

Ogni richiesta è registrata: chi ha letto cosa, quando, con quale esito. La creazione e la revoca dei token sono atti nella catena di evidenza dell'organizzazione.

In arrivo

Webhook firmati sugli eventi del programma Scuole e scrittura su richiesta. Scrivici a support@dronetrake.com.