Programiści

Otwarci na prośby

API rośnie na prawdziwych przypadkach. Jeśli brakuje Ci czegoś, jednego pola więcej, zdarzenia, zapisu z Twojego systemu, napisz do nas: oczekujemy konkretnych próśb i pozostajemy otwarci i dostępni, aby budować je razem. support@dronetrake.com

Specyfikacja

Specyfikacja OpenAPI 3.1 jest publiczna i aktualizowana z każdą wersją: 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

Uwierzytelnianie

Każde żądanie niesie token w nagłówku Authorization: Bearer. Tokeny tworzy się w panelu, w Business → API i integracje; należą do organizacji i mają jawne zakresy.

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

Zakresy

• organization.read — Organizacja (odczyt)
• school.read — Program Szkoły: uczniowie, zadania, poświadczenia (odczyt)
• operations.read — Operacje: misje i loty z godzinami na osobę (odczyt)

Limity

120 żądań na minutę na token. Powyżej: 429 z Retry-After.

Błędy

Zawsze JSON: {"error": {"code", "message"}}. 401 brak lub nieprawidłowy token, 403 niewystarczający zakres lub nieaktywny program, 404 nie znaleziono, 429 zbyt wiele żądań.

Webhooki

Zarejestruj endpoint https w panelu (Business → Webhooki) i wybierz zdarzenia. Każde dostarczenie to POST w JSON z nagłówkami X-Dronetrake-Event, X-Dronetrake-Delivery (unikalny id) i X-Dronetrake-Signature (t=<unix>,v1=HMAC-SHA256 treści z prefiksem t.). Odpowiedz 2xx w 10 sekund; w przeciwnym razie ponawiamy po 1 minucie, 5, 30, 2 godzinach i 12 godzinach, po czym dostarczenie zostaje porzucone i widać je w rejestrze. Trzydzieści porażek z rzędu wyłącza endpoint.

• school.task.accepted — Zadanie przyjęte przez ucznia
• school.task.declined — Zadanie odrzucone
• school.task.revoked — Zadanie cofnięte przez szkołę
• school.task.completed — Zadanie ukończone
• school.task.attested — Poświadczenie wydane
• school.student.enrolled — Uczeń zapisany
• school.student.left — Uczeń odszedł
• mission.completed — Misja ukończona
• flight.logged — Lot zapisany w dzienniku

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

Dowód

Każde żądanie jest rejestrowane: kto co odczytał, kiedy, z jakim wynikiem. Tworzenie i unieważnianie tokenów to akty w łańcuchu dowodowym organizacji.

Wkrótce

Podpisane webhooki dla zdarzeń programu Szkoły i zapis na życzenie. Napisz do nas na support@dronetrake.com.