Ontwikkelaars

Open voor verzoeken

De API groeit op echte gevallen. Mis je iets, een extra veld, een gebeurtenis, een schrijfactie vanuit jouw systeem, schrijf ons dan: we verwachten concrete verzoeken en blijven open en beschikbaar om ze samen te bouwen. support@dronetrake.com

Specificatie

De OpenAPI 3.1-specificatie is openbaar en wordt bij elke versie bijgewerkt: 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

Authenticatie

Elk verzoek draagt een token in de header Authorization: Bearer. Tokens maak je in het paneel onder Business → API & integraties; ze horen bij een organisatie en hebben expliciete rechten.

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

Rechten

• organization.read — Organisatie (lezen)
• school.read — Schoolprogramma: leerlingen, opdrachten, attesten (lezen)
• operations.read — Operaties: missies en vluchten met uren per persoon (lezen)

Limieten

120 verzoeken per minuut per token. Daarboven 429 met Retry-After.

Fouten

Altijd JSON: {"error": {"code", "message"}}. 401 token ontbreekt of ongeldig, 403 onvoldoende rechten of programma niet actief, 404 niet gevonden, 429 te veel verzoeken.

Webhooks

Registreer een https-endpoint in het paneel (Business → Webhooks) en kies de gebeurtenissen. Elke bezorging is een JSON-POST met de headers X-Dronetrake-Event, X-Dronetrake-Delivery (unieke id) en X-Dronetrake-Signature (t=<unix>,v1=HMAC-SHA256 van de body met prefix t.). Antwoord binnen 10 seconden met 2xx; anders proberen we opnieuw na 1 minuut, 5, 30, 2 uur en 12 uur, daarna is de bezorging opgegeven en zichtbaar in het log. Dertig mislukkingen op rij schakelen het endpoint uit.

• school.task.accepted — Opdracht geaccepteerd door de leerling
• school.task.declined — Opdracht geweigerd
• school.task.revoked — Opdracht ingetrokken door de school
• school.task.completed — Opdracht voltooid
• school.task.attested — Attest afgegeven
• school.student.enrolled — Leerling ingeschreven
• school.student.left — Leerling vertrokken
• mission.completed — Missie voltooid
• flight.logged — Vlucht in het logboek geregistreerd

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

Bewijs

Elk verzoek wordt gelogd: wie wat las, wanneer, met welk resultaat. Het aanmaken en intrekken van tokens zijn handelingen in de bewijsketen van de organisatie.

Binnenkort

Ondertekende webhooks bij gebeurtenissen van het schoolprogramma en schrijven op verzoek. Schrijf ons op support@dronetrake.com.