Προγραμματιστές

Ανοιχτοί σε αιτήματα

Το API μεγαλώνει πάνω σε πραγματικές περιπτώσεις. Αν χρειάζεσαι κάτι που δεν υπάρχει, ένα πεδίο ακόμη, ένα γεγονός, μια εγγραφή από το σύστημά σου, γράψε μας: περιμένουμε συγκεκριμένα αιτήματα και μένουμε ανοιχτοί και διαθέσιμοι να τα χτίσουμε μαζί. support@dronetrake.com

Προδιαγραφή

Η προδιαγραφή OpenAPI 3.1 είναι δημόσια και ενημερώνεται με κάθε έκδοση: 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

Αυθεντικοποίηση

Κάθε αίτημα φέρει ένα token στην κεφαλίδα Authorization: Bearer. Τα token δημιουργούνται στον πίνακα, στο Ενσωματώσεις → API και ενσωματώσεις, ανήκουν σε έναν οργανισμό και έχουν ρητά πεδία πρόσβασης.

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

Πεδία πρόσβασης

• organization.read — Οργανισμός (ανάγνωση)
• school.read — Πρόγραμμα σχολών: εκπαιδευόμενοι, εργασίες, βεβαιώσεις (ανάγνωση)
• operations.read — Επιχειρήσεις: αποστολές και πτήσεις με ώρες ανά άτομο (ανάγνωση)

Όρια

120 αιτήματα το λεπτό ανά token. Πέρα από αυτό, 429 με Retry-After.

Σφάλματα

Πάντα JSON: {"error": {"code", "message"}}. 401 token που λείπει ή δεν είναι έγκυρο, 403 ανεπαρκές πεδίο πρόσβασης ή μη ενεργό πρόγραμμα, 404 δεν βρέθηκε, 429 υπερβολικά πολλά αιτήματα.

Webhook

Καταχώρισε ένα endpoint https στον πίνακα (Ενσωματώσεις → Webhook) και διάλεξε τα γεγονότα. Κάθε παράδοση είναι ένα POST σε JSON με τις κεφαλίδες X-Dronetrake-Event, X-Dronetrake-Delivery (μοναδικό id) και X-Dronetrake-Signature (t=<unix>,v1=HMAC-SHA256 του σώματος με πρόθεμα t.). Απάντησε 2xx μέσα σε 10 δευτερόλεπτα· αλλιώς ξαναπροσπαθούμε μετά από 1 λεπτό, 5, 30, 2 ώρες και 12 ώρες, έπειτα η παράδοση εγκαταλείπεται και τη βλέπεις στο αρχείο. Τριάντα συνεχόμενες αποτυχίες απενεργοποιούν το endpoint.

• school.task.accepted — Η εργασία έγινε δεκτή από τον εκπαιδευόμενο
• school.task.declined — Η εργασία απορρίφθηκε
• school.task.revoked — Η εργασία ανακλήθηκε από τη σχολή
• school.task.completed — Η εργασία ολοκληρώθηκε
• school.task.attested — Εκδόθηκε βεβαίωση
• school.student.enrolled — Εγγραφή εκπαιδευόμενου
• school.student.left — Αποχώρηση εκπαιδευόμενου
• mission.completed — Η αποστολή ολοκληρώθηκε
• flight.logged — Η πτήση καταχωρήθηκε στο ημερολόγιο πτήσεων

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

Τεκμήρια

Κάθε αίτημα καταγράφεται: ποιος διάβασε τι, πότε, με ποιο αποτέλεσμα. Η δημιουργία και η ανάκληση token είναι πράξεις στην αλυσίδα τεκμηρίων του οργανισμού.

Έρχονται

Υπογεγραμμένα webhook στα γεγονότα του προγράμματος σχολών και εγγραφή κατόπιν αιτήματος. Γράψε μας στο support@dronetrake.com.