Desarrolladores

Abiertos a peticiones

La API crece con casos reales. Si necesitas algo que no está, un dato más, un evento, una escritura desde tu sistema, escríbenos: esperamos peticiones concretas y seguimos abiertos y disponibles para construirlas juntos. support@dronetrake.com

Especificación

La especificación OpenAPI 3.1 es pública y se actualiza con cada versión: 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

Autenticación

Cada solicitud lleva un token en la cabecera Authorization: Bearer. Los tokens se crean en el panel, en Business → API e integraciones, pertenecen a una organización y tienen ámbitos explícitos.

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

Ámbitos

• organization.read — Organización (lectura)
• school.read — Programa Escuelas: alumnos, tareas, certificaciones (lectura)
• operations.read — Operaciones: misiones y vuelos con las horas por persona (lectura)

Límites

120 solicitudes por minuto por token. Más allá, 429 con Retry-After.

Errores

Siempre JSON: {"error": {"code", "message"}}. 401 token ausente o inválido, 403 ámbito insuficiente o programa no activo, 404 no encontrado, 429 demasiadas solicitudes.

Webhooks

Registra un endpoint https en el panel (Business → Webhooks) y elige los eventos. Cada entrega es un POST en JSON con las cabeceras X-Dronetrake-Event, X-Dronetrake-Delivery (id único) y X-Dronetrake-Signature (t=<unix>,v1=HMAC-SHA256 del cuerpo con prefijo t.). Responde 2xx en 10 segundos; si no, reintentamos tras 1 minuto, 5, 30, 2 horas y 12 horas, y luego la entrega se abandona y queda en el registro. Treinta fallos seguidos apagan el endpoint.

• school.task.accepted — Tarea aceptada por el alumno
• school.task.declined — Tarea rechazada
• school.task.revoked — Tarea revocada por la escuela
• school.task.completed — Tarea completada
• school.task.attested — Certificación emitida
• school.student.enrolled — Alumno inscrito
• school.student.left — Alumno dado de baja
• mission.completed — Misión completada
• flight.logged — Vuelo registrado en el logbook

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

Evidencia

Cada solicitud queda registrada: quién leyó qué, cuándo, con qué resultado. Crear y revocar tokens son actos en la cadena de evidencia de la organización.

Próximamente

Webhooks firmados sobre eventos del programa Escuelas y escritura bajo petición. Escríbenos a support@dronetrake.com.