Entwickler

Offen für Anfragen

Die API wächst an echten Fällen. Wenn dir etwas fehlt, ein Feld, ein Ereignis, ein Schreibzugriff aus deinem System, schreib uns: wir erwarten konkrete Anfragen und bleiben offen und verfügbar, um sie gemeinsam zu bauen. support@dronetrake.com

Spezifikation

Die OpenAPI-3.1-Spezifikation ist öffentlich und wird mit jeder Version aktualisiert: 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

Authentifizierung

Jede Anfrage trägt einen Token im Header Authorization: Bearer. Tokens werden im Panel unter Business → API & Integrationen erstellt, gehören zu einer Organisation und haben explizite Berechtigungen.

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

Berechtigungen

• organization.read — Organisation (lesen)
• school.read — Schulprogramm: Schüler, Aufgaben, Bescheinigungen (lesen)
• operations.read — Einsätze: Missionen und Flüge mit Stunden pro Person (lesen)

Limits

120 Anfragen pro Minute und Token. Darüber hinaus 429 mit Retry-After.

Fehler

Immer JSON: {"error": {"code", "message"}}. 401 Token fehlt oder ungültig, 403 Berechtigung fehlt oder Programm nicht aktiv, 404 nicht gefunden, 429 zu viele Anfragen.

Webhooks

Registriere im Panel (Business → Webhooks) einen https-Endpoint und wähle die Ereignisse. Jede Zustellung ist ein JSON-POST mit den Headern X-Dronetrake-Event, X-Dronetrake-Delivery (eindeutige ID) und X-Dronetrake-Signature (t=<unix>,v1=HMAC-SHA256 des Bodys mit Präfix t.). Antworte innerhalb von 10 Sekunden mit 2xx; sonst wiederholen wir nach 1 Minute, 5, 30, 2 Stunden und 12 Stunden, dann gilt die Zustellung als aufgegeben und ist im Protokoll sichtbar. Dreißig Fehlschläge in Folge schalten den Endpoint ab.

• school.task.accepted — Aufgabe vom Schüler angenommen
• school.task.declined — Aufgabe abgelehnt
• school.task.revoked — Aufgabe von der Schule widerrufen
• school.task.completed — Aufgabe abgeschlossen
• school.task.attested — Bescheinigung ausgestellt
• school.student.enrolled — Schüler eingeschrieben
• school.student.left — Schüler ausgetreten
• mission.completed — Mission abgeschlossen
• flight.logged — Flug im Logbuch erfasst

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

Nachweis

Jede Anfrage wird protokolliert: wer was wann mit welchem Ergebnis gelesen hat. Das Erstellen und Widerrufen von Tokens sind Akte in der Nachweiskette der Organisation.

Demnächst

Signierte Webhooks zu Ereignissen des Schulprogramms und Schreibzugriff auf Anfrage. Schreib uns an support@dronetrake.com.