Dezvoltatori

Deschiși la cereri

API-ul crește pe cazuri reale. Dacă îți trebuie ceva ce nu există, un câmp în plus, un eveniment, o scriere din sistemul tău, scrie-ne: ne așteptăm la cereri concrete și rămânem deschiși și disponibili să le construim împreună. support@dronetrake.com

Specificație

Specificația OpenAPI 3.1 este publică și se actualizează cu fiecare versiune: 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

Autentificare

Fiecare cerere poartă un token în antetul Authorization: Bearer. Tokenurile se creează în panou, la Integrări → API și integrări, aparțin unei organizații și au domenii de acces explicite.

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

Domenii de acces

• organization.read — Organizație (citire)
• school.read — Programul Școli: cursanți, sarcini, atestări (citire)
• operations.read — Operațiuni: misiuni și zboruri cu orele pe persoană (citire)

Limite

120 de cereri pe minut per token. Peste, 429 cu Retry-After.

Erori

Întotdeauna JSON: {"error": {"code", "message"}}. 401 token lipsă sau invalid, 403 domeniu de acces insuficient sau program inactiv, 404 negăsit, 429 prea multe cereri.

Webhook-uri

Înregistrezi un endpoint https în panou (Integrări → Webhook-uri) și alegi evenimentele. Fiecare livrare este un POST în JSON cu antetele X-Dronetrake-Event, X-Dronetrake-Delivery (id unic) și X-Dronetrake-Signature (t=<unix>,v1=HMAC-SHA256 al corpului prefixat cu t.). Răspunde 2xx în 10 secunde; altfel reîncercăm după 1 minut, 5, 30, 2 ore și 12 ore, apoi livrarea este abandonată și rămâne vizibilă în registru. Treizeci de eșecuri la rând opresc endpointul.

• school.task.accepted — Sarcină acceptată de cursant
• school.task.declined — Sarcină refuzată
• school.task.revoked — Sarcină revocată de școală
• school.task.completed — Sarcină finalizată
• school.task.attested — Atestare emisă
• school.student.enrolled — Cursant înscris
• school.student.left — Cursant plecat
• mission.completed — Misiune finalizată
• flight.logged — Zbor înregistrat în jurnalul de zbor

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

Dovezi

Fiecare cerere este înregistrată: cine a citit ce, când, cu ce rezultat. Crearea și revocarea tokenurilor sunt acte în lanțul de dovezi al organizației.

Urmează

Webhook-uri semnate pe evenimentele programului Școli și acces de scriere la cerere. Scrie-ne la support@dronetrake.com.