Qué es la API
La API pública de Copilot EFB da acceso a los datos propios de cada piloto — aeronaves, fichas de aeródromo con sus frecuencias, pistas y calles de rodaje, meteorología en sus aeródromos, notas, checklists, rutas planificadas en el mapa, planes de vuelo, libro de vuelo y perfil — para que un servicio propio aproveche lo que ya llevás en el bolso de vuelo.
Lee todo. Desde la 1.18.0 también escribe, pero sólo con una clave a la que el piloto se lo haya permitido: cargar horas en el libro de vuelo, armar un plan de vuelo de punta a punta — planificación, navlog, plan OACI, validación, presentado, volado — y crear o modificar aeronaves, fichas de aeródromo, notas y checklists. Ver Escribir en la cuenta. El plugin RogerATC AI escribe lo suyo — activación, sesiones, estado en vivo, mensajes leídos — con cualquier clave.
La clave lee todo lo que tiene la cuenta, perfil del piloto incluido — números de licencia, certificado médico, teléfono — y las claves de proveedores que usa RogerATC. Guardala en un servidor. La API no envía encabezados CORS, a propósito, así que una página web no puede llamarla: nunca pongas la clave en una página web ni en una aplicación móvil.
La referencia en vivo, generada a partir del propio código de la API, está en api.rogeratc.app/docs, y la descripción OpenAPI 3.1, legible por máquina, en api.rogeratc.app/openapi.json. Esta página se contrasta con una copia de esa descripción cada vez que se genera el sitio.
Primeros pasos
Copiá la clave desde Copilot EFB → Ajustes → Acceso a la API y probala:
export ROGER_API_KEY="rat_live_…"
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/me
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/aircraft
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/weatherGET /v1/me es la forma más barata de comprobar que una clave funciona: indica a qué cuenta pertenece.
Tu clave de API
Cada cuenta de Copilot EFB tiene una clave personal desde el momento en que se confirma: no hay que solicitar nada. Está en Ajustes → Acceso a la API, junto con su uso.
| Momento | Qué ocurre |
|---|---|
| Cuenta confirmada | Se crea la clave. Una cuenta anterior a las claves la recibe en su próximo inicio de sesión. |
| Ajustes → Acceso a la API | Se muestra la clave, con sus primeros caracteres (prefix) para distinguir claves sin revelarlas. |
| Permitir cambios por la API | Apagado en toda clave. Encendido, la clave también puede escribir los registros del piloto (Escribir en la cuenta). Se comprueba en cada solicitud, así que al apagarlo se corta la escritura siguiente. |
| Rotar | Una clave nueva reemplaza a la anterior, que deja de funcionar en el instante en que termina la rotación. Cada integración que la usaba necesita la nueva. Se conserva el permiso de escritura; un reinicio de la cuenta rota la clave y lo apaga. |
| Cuenta pausada | La clave queda suspendida junto con la cuenta y responde 401. Al reactivar la cuenta, vuelve a funcionar. |
| Cuenta eliminada | La clave se elimina con todo lo demás. |
Formato: rat_live_ seguido de 43 caracteres base64url (32 bytes aleatorios). La API nunca devuelve la clave: GET /v1/me muestra sólo su prefijo y sus fechas.
Si alguien pudo haber visto la clave — una captura, un documento compartido, un commit —, rotala. La rotación es inmediata y sólo exige actualizar tus integraciones.
Estadísticas de uso
Ajustes → Acceso a la API muestra también cómo se usó la clave: solicitudes por día y por endpoint, hasta 90 días, cuántas fueron errores y cuándo se usó por última vez. Los contadores son por día UTC y por plantilla de ruta, por ejemplo GET /v1/aircraft/{id}.
Se cuenta cada solicitud a una ruta existente hecha con una clave válida, cualquiera sea su estado — un 404 por un registro que no existe, un 400, un 429 —, porque para eso están las estadísticas. Una ruta que no existe, y cualquier solicitud sin una clave válida, no se pueden atribuir a una cuenta y no se cuentan.
Autenticación
Enviá la clave en cada solicitud, en cualquiera de estos encabezados:
Authorization: Bearer rat_live_x3V…
X-API-Key: rat_live_x3V…Sólo GET /v1/health y la propia referencia — /docs y /openapi.json — responden sin clave.
Una clave ausente, mal formada, desconocida o rotada, o la clave de una cuenta pausada o eliminada, responde 401 unauthorized con WWW-Authenticate: Bearer. La API no dice cuál de esos casos fue.
Solicitudes y respuestas
- Métodos:
GETen todas partes;POST,PUT,PATCHyDELETEdonde los indican los endpoints. Sólo HTTPS (TLS 1.2 o posterior), sólo JSON. - Las horas están en UTC, ISO 8601. Las duraciones del libro de vuelo son minutos enteros.
- Un valor que la aplicación no conoce es
nullo no está — nunca se inventa. - Las respuestas con datos llevan
Cache-Control: no-store, private. - Toda respuesta lleva
X-Request-Id, el mismo valor quemeta.requestId. Citalo cuando algo salga mal.
Un recurso:
{
"data": {
"id": "ac-1",
"registration": "LV-XXX",
"icaoType": "C172",
"updatedAt": "2026-09-17T11:16:29.900Z",
"…": "…"
},
"meta": { "requestId": "Q2a8vg…", "generatedAt": "2026-09-17T15:02:11.410Z" }
}Una colección:
{
"data": [ { "id": "…", "…": "…" } ],
"page": { "limit": 50, "total": 2, "nextCursor": null },
"meta": { "requestId": "…", "generatedAt": "…" }
}Qué es un registro
Un registro se devuelve completo: cada campo que guarda la aplicación, tal como lo sincronizó el EFB, más id y updatedAt, que siempre están. Los registros eliminados nunca se devuelven.
Un campo que la aplicación agrega aparece en la API el mismo día en que se sincroniza, sin versión nueva. Ignora los campos que no reconozcas. Los ejemplos de esta página están recortados; un registro real trae más.
Errores
{
"error": { "code": "not_found", "message": "No aircraft with id \"x\" in this account." },
"meta": { "requestId": "…", "generatedAt": "…" }
}| Estado | code | Cuándo |
|---|---|---|
400 | bad_request | Un parámetro o un campo está mal formado; el mensaje lo nombra. |
401 | unauthorized | Sin clave, clave mal formada o desconocida, clave rotada, cuenta pausada o eliminada. |
403 | insufficient_scope | Una escritura con una clave a la que el piloto no le permitió escribir. |
403 | account_suspended | Una cuenta pausada, sólo en POST /v1/plugin/activation y GET /v1/plugin/credentials; toda otra ruta responde 401. |
404 | not_found | No existe la ruta, o no existe el registro en esta cuenta. |
405 | method_not_allowed | Un método que la ruta no acepta. Allow enumera los que sí. |
409 | conflict | Una escritura que choca con lo guardado: una matrícula o un aeródromo que la cuenta ya tiene, un plan cuyo vuelo ya pasó, o un registro que cambió mientras se aplicaba la solicitud — volvé a leerlo y reintentá. |
409 | not_armed | Una ejecución de tránsito nueva de un plan que el piloto no armó, en PUT /v1/plugin/transit-runs/{id}. |
410 | gone | Un PUT de una sesión del plugin que el piloto borró — dejá de enviarla; o un PUT de una ejecución de tránsito que el piloto borró, o cuyo plan borró; o una creación cuyo id o Idempotency-Key nombra un registro borrado. |
412 | precondition_failed | If-Match nombra una versión que el registro ya no es. ETag trae la actual. |
413 | payload_too_large | Un cuerpo por encima de su límite: 512 KB una sesión, 32 KB un reporte en vivo, 8 KB una activación, 400 KB una ejecución de tránsito. |
415 | unsupported_media_type | Un cuerpo que no es application/json. |
422 | unprocessable | JSON bien formado que la app rechazaría. error.problems lista todos los problemas como { field, code, message }; en un plan de vuelo, field es el número de casilla OACI. |
429 | rate_limited | Por encima del límite de la clave. Retry-After indica cuántos segundos esperar. |
500 | internal | Falla nuestra. Citá meta.requestId. |
503 | unavailable | Una escritura no se pudo guardar en este momento. Reintentá pasado Retry-After. |
Los códigos son estables: apoyate en ellos. Los mensajes son texto en inglés para quien desarrolla y pueden cambiar.
Paginación y seguimiento de cambios
Las colecciones aceptan:
| Parámetro | Significado |
|---|---|
limit | De 1 a 200, 50 por omisión. Una página puede traer menos cuando los registros son grandes: una nota puede llevar un dibujo. |
cursor | Opaco. Devuelve page.nextCursor para pedir la página siguiente; null significa que no hay más. |
updatedSince | ISO 8601. Sólo los registros modificados después de ese instante. |
El cursor es un desplazamiento dentro de la colección ordenada, así que un registro escrito entre dos pedidos de página puede correr una página. Para seguir los cambios, usá updatedSince con el updatedAt más reciente que hayas visto: así recibís cada cambio exactamente una vez, sin importar el orden.
curl -s -H "X-API-Key: $ROGER_API_KEY" \
"https://api.rogeratc.app/v1/aircraft?limit=100&updatedSince=2026-09-17T00:00:00Z"Límites de uso
- Por clave: 120 solicitudes por minuto. Por encima,
429 rate_limitedconRetry-Afteren segundos. - Toda la API: 25 solicitudes por segundo sostenidas, ráfagas de 50.
- La meteorología se guarda en caché hasta cinco minutos por aeródromo, sin importar cuántas veces la pidas;
fetchedAtindica cuándo se obtuvo. - Escrituras: 1.000 registros por cuenta y por día UTC — cada creación, modificación o borrado cuenta uno. Por encima,
429conRetry-Afterhasta las 00:00 UTC siguientes; una escritura rechazada no gasta nada. El tope existe porque cada escritura se sincroniza a todos los dispositivos del piloto. - Sesiones del plugin: 50 identificadores de sesión nuevos por cuenta y por día UTC. Las actualizaciones de un id existente no tienen límite.
Escribir en la cuenta
Una clave a la que el piloto le permitió escribir puede cambiar lo que el piloto carga: asientos del libro de vuelo, aeronaves, fichas de aeródromo, notas, checklists, planificaciones y planes de vuelo. Cada escritura se guarda igual que un cambio hecho en uno de los dispositivos del piloto, así que aparece en todos en su próxima sincronización. El perfil del piloto, las planificaciones compartidas, los adjuntos y los mensajes no se pueden escribir.
La escritura está apagada en toda clave hasta que el piloto activa Copilot EFB → Ajustes → Acceso a la API → Permitir cambios por la API. Una clave de sólo lectura recibe 403 insufficient_scope. RogerATC no necesita permiso de escritura.
| Acción | Cómo |
|---|---|
| Crear | POST sobre la colección → 201 con el registro completo, su ETag, y warnings o validation donde la app los tiene. |
| Reintentar sin duplicar | Enviá Idempotency-Key (de 1 a 255 caracteres ASCII) o un id UUID en el cuerpo. Un reintento responde 200 con el registro guardado e Idempotent-Replayed: true. |
| Modificar | PATCH es un JSON Merge Patch: cambia sólo lo que nombrás, null quita un campo y una lista se reemplaza entera. PUT reemplaza el registro (no existe para planificaciones ni planes de vuelo). |
| Concurrencia | Toda lectura y escritura de un registro trae ETag. Devolvelo como If-Match para que una modificación o un borrado sean condicionales (412 si cambió); sin él gana la última escritura, como entre dos dispositivos. |
| Borrar | DELETE → 200 { id, deleted: true, alsoDeleted }, y otra vez 200 en un reintento. |
| Rechazo | 422 unprocessable lista todos los problemas juntos; no se escribe nada. |
Cargar horas en el libro de vuelo
Una llamada agrega un vuelo. Con departureAt y arrivalAt y sin times, el tiempo calzo a calzo va a la celda que corresponde al tipo de vuelo y a la función, igual que en la pantalla del libro; GET /v1/logbook/totals lo cuenta en el acto.
curl -X POST https://api.rogeratc.app/v1/logbook \
-H "Authorization: Bearer $ROGER_API_KEY" -H "Content-Type: application/json" \
-H "Idempotency-Key: flight-2026-10-09-1" \
-d '{ "date": "2026-10-09", "departureAt": "2026-10-09T13:05:00Z", "arrivalAt": "2026-10-09T14:55:00Z",
"departureAerodrome": "SADF", "arrivalAerodrome": "SAAR", "kind": "crossCountry",
"registration": "LV-ABC", "landings": 1 }'{
"data": { "id": "…", "source": "manual", "departure": "SADF", "destination": "SAAR",
"log": { "date": "2026-10-09", "kind": "crossCountry", "role": "pilot",
"times": { "crossCountryDayPilot": 110, "…": 0 }, "landings": 1 },
"updatedAt": "…" },
"meta": { "requestId": "…", "generatedAt": "…" }
}Una línea que la app rechazaría no se escribe, y se listan todos los problemas:
{
"error": { "code": "unprocessable", "message": "The logbook line has problems; nothing was written.",
"problems": [ { "field": "date", "code": "required", "message": "\"date\" is required: the flight’s date, YYYY-MM-DD." } ] },
"meta": { "requestId": "…", "generatedAt": "…" }
}Un plan de vuelo de punta a punta
- La aeronave, una vez:
POST /v1/aircraft. - La planificación — salida, ruta, destino, alternativas, aeronave, hora, nivel, combustible, viento:
POST /v1/plannings. - Su navlog — tramos, rumbos, tiempos, combustible:
GET /v1/plannings/{id}/navlog. - El plan de vuelo OACI que resulta, como borrador y con su validación:
POST /v1/plannings/{id}/flight-plan. - Lo que sólo el piloto puede declarar — personas a bordo, casilla 19:
PATCH /v1/flight-plans/{id}. - Verificarlo como lo hace la app:
GET /v1/flight-plans/{id}/validation. - Marcarlo presentado — rechazado con
422mientras el validador informe un error:PATCH /v1/flight-plans/{id}. - Después del vuelo, las horas:
POST /v1/logbook. - Cerrar el plan como volado:
PATCH /v1/flight-plans/{id}.
export ROGER_API_KEY="rat_live_…" # a key with "Allow changes through the API" on
H=(-H "Authorization: Bearer $ROGER_API_KEY" -H "Content-Type: application/json")
API=https://api.rogeratc.app
# 1. The aircraft (once).
AC=$(curl -s -X POST "${H[@]}" $API/v1/aircraft -d '{"registration":"LV-ABC","icaoType":"C172",
"cruiseTas":105,"cruiseFuelBurn":32,"usableFuel":200,"taxiFuel":4,"volumeUnit":"l",
"equipmentCodes":"SDFGY","surveillanceCodes":"C"}' | jq -r .data.id)
# 2. The planning: route, aircraft, time, level, fuel, wind.
PL=$(curl -s -X POST "${H[@]}" $API/v1/plannings -d '{"departure":"SADF",
"route":[{"ident":"FDO","kind":"navaid"},{"airway":"W5","to":"ROS"}],"destination":"SAAR",
"alternates":["SAAV"],"aircraftId":"'$AC'","departureAt":"2026-10-10T13:00:00Z",
"cruiseAltitudeFt":4500,"fuelAtDeparture":150,"windSource":"manual",
"manualWind":{"fromTrueDeg":270,"speedKt":15}}' | jq -r .data.id)
# 3. Its navigation log.
curl -s "${H[@]}" $API/v1/plannings/$PL/navlog | jq '.data | {totalDistanceNm, totalTimeMin, tripFuel, fuelStatus}'
# 4. The ICAO flight plan it becomes (a draft, with its validation).
FP=$(curl -s -X POST "${H[@]}" -H "Idempotency-Key: fpl-$PL" $API/v1/plannings/$PL/flight-plan | jq -r .data.id)
# 5. What only the pilot can state: persons on board, field 19.
curl -s -X PATCH "${H[@]}" $API/v1/flight-plans/$FP -d '{"supplementary":{"personsOnBoard":2,
"pilotInCommand":"A. PILOT","contactPhone":"+10000000000"}}'
# 6. Check it as the app does.
curl -s "${H[@]}" $API/v1/flight-plans/$FP/validation | jq '.data | {filable, issues}'
# 7. Mark it filed (422 while the validator reports an error).
curl -s -X PATCH "${H[@]}" $API/v1/flight-plans/$FP -d '{"status":"filed"}'
# 8. After the flight: the hours, in the logbook.
curl -s -X POST "${H[@]}" $API/v1/logbook -d '{"date":"2026-10-10","departureAt":"2026-10-10T13:00:00Z",
"arrivalAt":"2026-10-10T14:20:00Z","departureAerodrome":"SADF","arrivalAerodrome":"SAAR",
"kind":"crossCountry","aircraftId":"'$AC'","landings":1}'
# 9. And close the plan.
curl -s -X PATCH "${H[@]}" $API/v1/flight-plans/$FP -d '{"status":"flown"}'La API marca un plan como presentado; no lo envía. Enviarlo a la oficina ARO-AIS, firmarlo y buscar el viento pronosticado siguen en la app. El navlog de una planificación usa un viento manual o ninguno: el pronosticado no se busca, y el navlog lo dice.
Endpoints
Toda ruta salvo GET /v1/health necesita la clave; las que cambian los registros del piloto necesitan una clave con permiso de escritura. Las colecciones se paginan y ordenan como se indica en cada una.
| Método | Ruta | Clave | Devuelve |
|---|---|---|---|
| GET | /v1/health | no | Estado del servicio |
| GET | /v1/me | sí | La cuenta y su clave |
| GET | /v1/aerodromes | sí | Fichas de aeródromo (paginadas) |
| GET | /v1/aerodromes/{id} | sí | Una ficha, por id o por identificador |
| GET | /v1/aerodromes/{id}/attachments/{attachmentId} | sí | Enlace de descarga de un adjunto de la ficha |
| GET | /v1/aerodrome-comments/{ident} | sí | Comentarios aprobados de pilotos sobre un aeródromo |
| POST | /v1/aerodromes | sí | Crear una ficha, completada desde la base (escritura) |
| PATCH | /v1/aerodromes/{id} | sí | Modificar una ficha (escritura) |
| PUT | /v1/aerodromes/{id} | sí | Reemplazar una ficha (escritura) |
| DELETE | /v1/aerodromes/{id} | sí | Borrar una ficha (escritura) |
| GET | /v1/aircraft | sí | Aeronaves (paginadas) |
| GET | /v1/aircraft/{id} | sí | Una aeronave |
| GET | /v1/aircraft/{id}/attachments/{attachmentId} | sí | Enlace de descarga de un documento de la aeronave |
| POST | /v1/aircraft | sí | Crear una aeronave (escritura) |
| PATCH | /v1/aircraft/{id} | sí | Modificar una aeronave (escritura) |
| PUT | /v1/aircraft/{id} | sí | Reemplazar una aeronave (escritura) |
| DELETE | /v1/aircraft/{id} | sí | Borrar una aeronave y sus checklists (escritura) |
| GET | /v1/weather | sí | METAR y TAF en cada aeródromo del piloto |
| GET | /v1/weather/{ident} | sí | METAR y TAF en un aeródromo |
| GET | /v1/aerodrome-knowledge/{ident} | sí | Todo lo que el EFB sabe de un aeródromo |
| GET | /v1/aerodrome-knowledge | sí | Aeródromos y frecuencias de TMA del piloto alrededor de una posición |
| GET | /v1/notes | sí | Notas (paginadas) |
| GET | /v1/notes/{id} | sí | Una nota |
| POST | /v1/notes | sí | Crear una nota (escritura) |
| PATCH | /v1/notes/{id} | sí | Modificar una nota (escritura) |
| PUT | /v1/notes/{id} | sí | Reemplazar una nota (escritura) |
| DELETE | /v1/notes/{id} | sí | Borrar una nota (escritura) |
| GET | /v1/checklists | sí | Checklists (paginadas) |
| GET | /v1/checklists/{id} | sí | Una checklist |
| POST | /v1/checklists | sí | Crear una checklist (escritura) |
| PATCH | /v1/checklists/{id} | sí | Modificar una checklist (escritura) |
| PUT | /v1/checklists/{id} | sí | Reemplazar una checklist (escritura) |
| DELETE | /v1/checklists/{id} | sí | Borrar una checklist (escritura) |
| GET | /v1/check-flights | sí | Vuelos de checklists (paginados) |
| GET | /v1/check-flights/{id} | sí | Un vuelo |
| GET | /v1/flight-plans | sí | Planes de vuelo (paginados) |
| GET | /v1/flight-plans/{id} | sí | Un plan de vuelo |
| POST | /v1/flight-plans | sí | Crear un plan a partir de campos (escritura) |
| PATCH | /v1/flight-plans/{id} | sí | Modificar, presentar o cerrar un plan (escritura) |
| DELETE | /v1/flight-plans/{id} | sí | Borrar un plan (escritura) |
| GET | /v1/flight-plans/{id}/validation | sí | La validación de la app y el mensaje FPL |
| GET | /v1/plannings | sí | Planificaciones (paginadas) |
| GET | /v1/plannings/{id} | sí | Una planificación |
| POST | /v1/plannings | sí | Crear una planificación desde salida, ruta y destino (escritura) |
| PATCH | /v1/plannings/{id} | sí | Modificar una planificación (escritura) |
| DELETE | /v1/plannings/{id} | sí | Borrar una planificación (escritura) |
| GET | /v1/plannings/{id}/navlog | sí | Su navlog, calculado |
| POST | /v1/plannings/{id}/flight-plan | sí | Hacer el plan de vuelo OACI desde ella (escritura) |
| GET | /v1/shared-plannings | sí | Planificaciones compartidas con un copiloto |
| GET | /v1/shared-plannings/{id} | sí | Una planificación compartida |
| GET | /v1/airways | sí | Rutas ATS (aerovías) del AIP Argentina |
| GET | /v1/logbook | sí | Asientos del libro de vuelo (paginados) |
| GET | /v1/logbook/totals | sí | Horas sumadas, en minutos |
| GET | /v1/logbook/export | sí | El libro de vuelo como archivo CSV |
| GET | /v1/logbook/{id} | sí | Un asiento |
| GET | /v1/logbook/{id}/attachments/{attachmentId} | sí | Enlace de descarga de una foto del asiento |
| POST | /v1/logbook | sí | Cargar horas: un asiento nuevo (escritura) |
| PATCH | /v1/logbook/{id} | sí | Modificar un asiento (escritura) |
| PUT | /v1/logbook/{id} | sí | Reemplazar un asiento (escritura) |
| DELETE | /v1/logbook/{id} | sí | Borrar un asiento (escritura) |
| GET | /v1/ground-school | sí | El recorrido teórico y dónde está el piloto |
| GET | /v1/transit-plans | sí | Planes de sesiones de tránsito instruidas (paginados) |
| GET | /v1/transit-plans/{id} | sí | Un plan de sesión de tránsito |
| GET | /v1/transit-runs | sí | Ejecuciones de sesiones de tránsito informadas por el plugin (paginadas) |
| GET | /v1/transit-runs/{id} | sí | Una ejecución — el punto para retomar si X-Plane se cerró |
| GET | /v1/pilot | sí | El perfil del piloto |
| POST | /v1/plugin/activation | sí | La verificación de licencia de RogerATC: la cuenta y los nombres de sus claves |
| GET | /v1/plugin/credentials | sí | Las claves de proveedores que usa RogerATC, desde los Ajustes del piloto |
| GET | /v1/plugin/feedback | sí | Las calificaciones de un administrador a turnos de RogerATC, como conjunto de entrenamiento |
| POST | /v1/plugin/feedback/applied | sí | Marcar calificaciones incorporadas en una versión del plugin |
| GET | /v1/plugin/messages | sí | Los mensajes sin leer del piloto, para que el instructor los lea en voz alta |
| POST | /v1/plugin/messages/{id}/read | sí | Marcar uno como leído, en todos los dispositivos |
| PUT | /v1/plugin/sessions/{id} | sí | Guardar una sesión de RogerATC AI |
| PUT | /v1/plugin/live | sí | Informa el estado en vivo y recoge las instrucciones pendientes |
| PUT | /v1/plugin/transit-runs/{id} | sí | Guarda una ejecución de una sesión de tránsito instruida |
| GET | /v1/plugin/sessions | sí | Sesiones de RogerATC AI (paginadas) |
| GET | /v1/plugin/sessions/{id} | sí | Una sesión de RogerATC AI |
| GET | /v1/plugin/stats | sí | Totales de todas las sesiones de RogerATC AI |
Estado del servicio
- GET
/v1/healthEstado del servicio sin clave
Sin clave, sin datos y sin contar en las estadísticas de uso. Para monitores de disponibilidad.
curl -s https://api.rogeratc.app/v1/health{ "data": { "ok": true, "version": "1.0.0" }, "meta": { … } }Cuenta
- GET
/v1/meLa cuenta y su clave
A qué cuenta pertenece una clave. La clave nunca se devuelve: sólo su prefijo y sus fechas.
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/me{
"data": {
"userId": "00000000-0000-0000-0000-000000000000",
"email": "…",
"displayName": "A. Pilot",
"accountCreatedAt": "2026-09-08T18:15:14.171Z",
"apiKey": {
"prefix": "rat_live_x3V9",
"createdAt": "2026-09-17T15:00:00.000Z",
"rotatedAt": null
}
},
"meta": { … }
}Fichas de aeródromo
- GET
/v1/aerodromesFichas de aeródromo (paginadas) - GET
/v1/aerodromes/{id}Una ficha, por id o por identificador - GET
/v1/aerodromes/{id}/attachments/{attachmentId}Enlace de descarga de un adjunto de la ficha - GET
/v1/aerodrome-comments/{ident}Comentarios aprobados de pilotos sobre un aeródromo - POST
/v1/aerodromesCrear una ficha, completada desde la base (escritura) - PATCH
/v1/aerodromes/{id}Modificar una ficha (escritura) - PUT
/v1/aerodromes/{id}Reemplazar una ficha (escritura) - DELETE
/v1/aerodromes/{id}Borrar una ficha (escritura)
Las fichas de aeródromo del piloto: frecuencias, contactos, VOR/DME, pistas, calles de rodaje, posición, elevación, notas y el texto de NOTAM y MADHEL que el piloto copió en la ficha. Ordenadas por code.
| Parámetro | Significado |
|---|---|
limit · cursor · updatedSince | Paginación — ver Paginación y seguimiento de cambios. |
{id} | El id de la ficha o el identificador del aeródromo, sin distinguir mayúsculas: /v1/aerodromes/SADF, /v1/aerodromes/len. |
El identificador es el indicador de lugar OACI cuando el aeródromo lo tiene, y el código nacional de tres letras cuando no — como en la mayoría de las pistas argentinas, por ejemplo LEN (Escobar) o SNY (San Nicolás).
taxiways es una lista de { id, designator, surface, widthM, lighted, notes } que el piloto carga desde la carta del aeródromo; nunca viene precargada. Una lista vacía o ausente significa que no se cargó ninguna en la ficha, y no dice nada sobre el aeródromo.
Son las fichas del propio piloto, datos de referencia cargados desde una carta. No son la AIP.
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/aerodromes/SADF{
"data": {
"id": "7f0c…", "code": "SADF", "name": "San Fernando", "elevationFt": 10,
"frequencies": { "tower": "119.000", "ground": "121.850", "atis": null, "…": "…" },
"contacts": { "aroAisPhone": "…", "…": "…" },
"runways": [
{ "designator": "05/23", "lengthM": 1690, "widthM": 30, "surface": "ASP", "…": "…" }
],
"taxiways": [
{ "id": "…", "designator": "…", "surface": "…", "widthM": null,
"lighted": null, "notes": "…" }
],
"notam": "", "madhel": "", "notes": "",
"createdAt": "…", "updatedAt": "…"
},
"meta": { … }
}Adjuntos
attachments lista los diagramas, procedimientos de entrada y salida y fotos que el piloto adjuntó: { id, name, contentType, bytes, kind, createdAt }, con kind diagram, procedures, photo u other. La ficha sólo lleva esos datos; los archivos están en un almacenamiento privado. GET /v1/aerodromes/{id}/attachments/{attachmentId} devuelve uno con una URL HTTPS firmada, válida por 15 minutos: pedila directamente y sin la clave. 404 si la ficha no lista ese id o si el archivo todavía no se subió — un adjunto agregado sin señal se sube en la siguiente sincronización.
curl -s -H "Authorization: Bearer $ROGER_API_KEY" \
"https://api.rogeratc.app/v1/aerodromes/SADF/attachments/0b7e…"{
"data": {
"id": "0b7e…", "name": "SADF diagrama.pdf", "contentType": "application/pdf",
"bytes": 812345, "kind": "diagram", "createdAt": "2026-09-18T12:00:00.000Z",
"url": "https://…/u/…?X-Amz-Signature=…",
"urlExpiresAt": "2026-09-18T12:15:00.000Z"
},
"meta": { … }
}Escritura
code se resuelve a la identidad del aeródromo — EZE y SAEZ son una sola ficha — y una segunda ficha del mismo aeródromo es 409. Una ficha nueva se completa desde la base de aeródromos del EFB, como Agregar aeródromo en la app, con tu cuerpo encima. Las escrituras usan el id de la ficha; el GET acepta también un identificador. Los adjuntos nunca se escriben: los archivos se suben desde la app. Convenciones en Escribir en la cuenta.
Comentarios de pilotos
GET /v1/aerodrome-comments/{ident} (1.33.0) devuelve lo que escribieron los pilotos sobre un aeródromo una vez que un administrador lo aprobó, primero lo más reciente, hasta 100, más los comentarios propios de esta cuenta en cualquier status (pending o rejected). Cualquier código del aeródromo lo encuentra: SADF, FDO y sadf leen la misma lista. authorName es el nombre y la inicial del apellido, o null. Sólo texto: hasPhoto y hasFile dicen que hay una foto o un diagrama compartido, y photoUrl, thumbUrl y file.url son siempre null acá. Sólo lectura; los comentarios se escriben y moderan en la app.
Aeronaves
- GET
/v1/aircraftAeronaves (paginadas) - GET
/v1/aircraft/{id}Una aeronave - GET
/v1/aircraft/{id}/attachments/{attachmentId}Enlace de descarga de un documento de la aeronave - POST
/v1/aircraftCrear una aeronave (escritura) - PATCH
/v1/aircraft/{id}Modificar una aeronave (escritura) - PUT
/v1/aircraft/{id}Reemplazar una aeronave (escritura) - DELETE
/v1/aircraft/{id}Borrar una aeronave y sus checklists (escritura)
Cada perfil de aeronave con todos sus campos: matrícula, tipo OACI, códigos de equipamiento y de vigilancia, velocidades, combustible, pesos, brazos y envolvente. Ordenados por registration.
| Parámetro | Significado |
|---|---|
limit · cursor · updatedSince | Paginación — ver Paginación y seguimiento de cambios. |
curl -s -H "Authorization: Bearer $ROGER_API_KEY" "https://api.rogeratc.app/v1/aircraft?limit=20"Documentos
attachments lista el manual de vuelo, los documentos y las fotos de la aeronave, con la misma forma que los de una ficha y kind manual, document, photo u other. GET /v1/aircraft/{id}/attachments/{attachmentId} funciona igual que el de aeródromos: una URL firmada por 15 minutos, sin la clave, y 404 si no existe o todavía no se subió. Un archivo puede pesar hasta 100 MB.
Escritura
registration es obligatoria, y una que la flota ya tiene (LV-ABC es lvabc) es 409. Se verifican las listas cerradas — categoría, estela turbulenta, unidades, tipo de combustible. DELETE borra también las checklists de la aeronave, como la app, y las lista en alsoDeleted.
Meteorología
- GET
/v1/weatherMETAR y TAF en cada aeródromo del piloto - GET
/v1/weather/{ident}METAR y TAF en un aeródromo
El último METAR y TAF, en crudo y decodificados, para cada aeródromo que tiene el piloto: cada ficha de aeródromo y cada aeródromo de su briefing meteorológico. sources indica de dónde sale (aerodromeCard, briefing). /v1/weather/{ident} responde para cualquier identificador, esté o no en las listas del piloto.
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/weather{
"data": [
{
"ident": "SAEZ", "name": "Ezeiza", "sources": ["aerodromeCard", "briefing"],
"status": "ok",
"metar": {
"raw": "METAR SAEZ 171400Z 35009KT CAVOK 21/10 Q1023 NOSIG",
"observedAt": "2026-09-17T14:00:00.000Z",
"ageMinutes": 12,
"flightCategory": "VFR",
"decoded": { "wind": { … }, "ceilingAglFt": null, "unparsed": [], "…": "…" }
},
"taf": {
"raw": "TAF SAEZ 171100Z 1712/1812 …",
"issuedAt": "…", "validFrom": "…", "validTo": "…",
"decoded": { … }
},
"provider": "NOAA Aviation Weather Center (aviationweather.gov)",
"fetchedAt": "2026-09-17T14:12:03.000Z"
},
{
"ident": "LEN", "name": "Escobar", "sources": ["aerodromeCard"],
"status": "no_icao_indicator",
"metar": null, "taf": null, "provider": "…", "fetchedAt": null
}
],
"meta": { … }
}status | Significado |
|---|---|
ok | Un METAR, un TAF o ambos. Cada uno lleva su fecha; nada se descarta por viejo. |
no_report | Se consultó a NOAA y no tiene nada para ese indicador. |
no_icao_indicator | El aeródromo se identifica con un código nacional; no hay estación a la cual consultar. |
unavailable | No se pudo contactar a NOAA. No es lo mismo que no haya meteorología. |
Por qué nada se inventa
decoded es la salida del propio decodificador del EFB, así que la API y la pantalla no pueden discrepar sobre un techo. Los grupos que el decodificador no entiende se listan en unparsed; nunca se adivinan.
Un reporte nunca se descarta por viejo: cada uno trae su hora y ageMinutes, y decidir si es demasiado viejo te corresponde a vos. Los cuatro estados se mantienen separados a propósito: un aeródromo sin estación a la cual consultar, o un proveedor que no respondió, no son un aeródromo sin meteorología. provider nombra la fuente en cada elemento.
Lo que se sabe de un aeródromo
- GET
/v1/aerodrome-knowledge/{ident}Todo lo que el EFB sabe de un aeródromo - GET
/v1/aerodrome-knowledgeAeródromos y frecuencias de TMA del piloto alrededor de una posición
Una sola respuesta para un aeródromo, unida por cada código con el que se lo conoce (SADM, MOR, lo que el piloto haya escrito en la ficha): card — la ficha propia del piloto, completa, con su fecha; reference — el registro de OurAirports que trae la app; madhel — la página del MADHEL de ANAC, con su texto tal cual; notams — los NOTAM vigentes de ANAC, hasta 25 con total; weather — igual que /v1/weather/{ident}. Pensado para el instructor de RogerATC AI, disponible para cualquier integración.
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/aerodrome-knowledge/SADM
curl -s -H "Authorization: Bearer $ROGER_API_KEY" \
"https://api.rogeratc.app/v1/aerodrome-knowledge?lat=-34.68&lon=-58.64&radiusNm=20"{
"data": {
"ident": "SADM", "asked": "SADM", "icao": "SADM", "localCode": "MOR",
"name": "Morón Airport", "generatedAt": "2026-10-12T12:00:00.000Z",
"card": {
"source": "The pilot’s own aerodrome card in Copilot EFB",
"updatedAt": "2026-10-01T10:00:00.000Z",
"record": { "code": "MOR", "frequencies": { "twr": "118.500", "tma1": "119.900" },
"taxiways": [{ "designator": "A" }], "…": "…" }
},
"reference": { "source": "OurAirports (ourairports.com), public domain",
"runways": [{ "designator": "02/20", "…": "…" }],
"frequencies": [{ "type": "TWR", "description": "Moron Torre", "mhz": "118.500" }] },
"madhel": { "source": "ANAC Argentina — MADHEL …", "status": "record",
"fetchedAt": "2026-10-12T11:58:40.000Z", "record": { "particularNorms": { "content": "…" }, "…": "…" } },
"notams": { "source": "ANAC Argentina / EANA — AIS NOTAM …", "status": "none",
"fetchedAt": "…", "sourceUpdatedAtText": "…", "total": 0, "items": [] },
"weather": { "ident": "SADM", "status": "ok", "…": "…" }
},
"meta": { "requestId": "…", "generatedAt": "…" }
}status (MADHEL · NOTAM) | Significado |
|---|---|
record · notams | ANAC respondió: la página, o los NOTAM vigentes. |
none | La ausencia fechada que declara ANAC: no hay página con ese código, o no figura en el índice de NOTAM. El único estado que significa que no hay nada. |
unknown | Fuera del alcance de ANAC: un aeródromo del exterior o sin código nacional. No se consultó. |
unavailable | No se pudo contactar a ANAC. No es lo mismo que none. |
La forma por posición, lista los aeródromos y las fichas del piloto alrededor de un punto, del más cercano al más lejano, cada uno con distanceNm, y areaFrequencies: las frecuencias de sector de la TMA que el piloto anotó en fichas dentro del radio, cada valor una vez, con la ficha de donde sale. No consulta a ningún proveedor; para MADHEL, NOTAM y meteorología está la forma {ident}. 400 para un código que no tenga 3 o 4 letras o dígitos, o una posición, radio o límite fuera de rango; 404 cuando el código no está en la referencia, ni en las fichas del piloto, ni en el MADHEL.
| Parámetro | Significado |
|---|---|
lat | Latitud, grados decimales, de −90 a 90. Obligatorio. |
lon | Longitud, grados decimales, de −180 a 180. Obligatorio. |
radiusNm | Millas náuticas, de 1 a 100. Por defecto 25. |
limit | Aeródromos devueltos, de 1 a 20. Por defecto 8. |
Por qué nada se mezcla
Una frecuencia que anotó el piloto y otra que publica una base de datos son dos afirmaciones de dos partes, así que cada bloque conserva su propio source y su propia fecha, y ninguno se funde con otro. El espacio aéreo no está acá: viene de openAIP con la clave del propio piloto, y nuestros servidores nunca llaman a un proveedor con la clave de un piloto. Los datos de ANAC se transmiten tal cual y atribuidos, en cada pedido; ANAC no publica una licencia para la API del MADHEL (verificado el 2026-10-12).
Notas
- GET
/v1/notesNotas (paginadas) - GET
/v1/notes/{id}Una nota - POST
/v1/notesCrear una nota (escritura) - PATCH
/v1/notes/{id}Modificar una nota (escritura) - PUT
/v1/notes/{id}Reemplazar una nota (escritura) - DELETE
/v1/notes/{id}Borrar una nota (escritura)
La tablilla de rodilla: cada nota con todos sus campos, incluida la imagen de una nota manuscrita como data URL PNG (imageDataUrl). Primero el cambio más reciente. Nada de una nota se interpreta.
| Parámetro | Significado |
|---|---|
limit · cursor · updatedSince | Paginación — ver Paginación y seguimiento de cambios. |
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/notesEscritura
title, body, kind, un imageDataUrl PNG opcional, y aircraftId o flightId de esta cuenta. Una nota vacía se rechaza, como la descarta la app.
Checklists
- GET
/v1/checklistsChecklists (paginadas) - GET
/v1/checklists/{id}Una checklist - POST
/v1/checklistsCrear una checklist (escritura) - PATCH
/v1/checklists/{id}Modificar una checklist (escritura) - PUT
/v1/checklists/{id}Reemplazar una checklist (escritura) - DELETE
/v1/checklists/{id}Borrar una checklist (escritura)
Cada checklist que el piloto armó a partir de la documentación de su aeronave, con sus secciones e ítems. Ordenadas por aeronave y luego por el orden que eligió el piloto. El EFB no trae checklists precargadas: cada una la escribió el piloto.
| Parámetro | Significado |
|---|---|
limit · cursor · updatedSince | Paginación — ver Paginación y seguimiento de cambios. |
aircraftId | Sólo las checklists de esa aeronave — un id de GET /v1/aircraft. |
curl -s -H "Authorization: Bearer $ROGER_API_KEY" \
"https://api.rogeratc.app/v1/checklists?aircraftId=ac-1"Escritura
Debe nombrar una aeronave del piloto. sections[].items[] se verifican campo por campo — challenge es obligatorio, y type es challengeResponse, check, value o note. Queda última en el orden de la aeronave salvo que order diga otra cosa.
Vuelos de checklists
- GET
/v1/check-flightsVuelos de checklists (paginados) - GET
/v1/check-flights/{id}Un vuelo
Un registro por cada vuelo en el que se corrieron las checklists de una aeronave: startedAt, completedAt (ausente mientras el vuelo sigue abierto: muchas listas se corren en el aire), lists en el orden de ese día y summary: { total, done, missing: [{ checklist, section, challenge, critical }] }. El resumen se toma mientras transcurre el vuelo, así que sigue diciendo qué quedó sin tildar aunque después se edite o borre la lista. autoClosed: true marca un vuelo que cerró la app y no el piloto: uno abierto más de doce horas se cierra en su última actividad, nunca en el momento en que se lo notó.
| Parámetro | Significado |
|---|---|
limit · cursor · updatedSince | Paginación — ver Paginación y seguimiento de cambios. |
aircraftId | Sólo los vuelos de esa aeronave — un id de GET /v1/aircraft. |
curl -s -H "Authorization: Bearer $ROGER_API_KEY" \
"https://api.rogeratc.app/v1/check-flights?aircraftId=ac-1"Planes de vuelo
- GET
/v1/flight-plansPlanes de vuelo (paginados) - GET
/v1/flight-plans/{id}Un plan de vuelo - POST
/v1/flight-plansCrear un plan a partir de campos (escritura) - PATCH
/v1/flight-plans/{id}Modificar, presentar o cerrar un plan (escritura) - DELETE
/v1/flight-plans/{id}Borrar un plan (escritura) - GET
/v1/flight-plans/{id}/validationLa validación de la app y el mensaje FPL
Cada plan de vuelo OACI con todos sus campos: casillas 7 a 19, los puntos de la ruta, la información suplementaria y la dirección de presentación. Primero la departureDate más reciente. Un plan hecho desde una planificación lleva planningId.
| Parámetro | Significado |
|---|---|
limit · cursor · updatedSince | Paginación — ver Paginación y seguimiento de cambios. |
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/flight-plansEscritura
POST arma un plan a partir de campos, como lo hace el asistente del EFB: los aeródromos resueltos a sus indicadores, route como casilla 15 ("DCT FDO W5 ROS DCT"), lo que precarga la aeronave desde aircraftId, departureAt en la casilla 13 y DOF/, cruiseAltitudeFt a un nivel, y reuseFrom (un id de plan, o "latest") para los datos fijos de un plan anterior. Un campo desconocido es 422.
PATCH lo modifica campo por campo. status filed se acepta sólo mientras el validador no informe errores; flown y cancelled lo cierran. Un plan cuyo vuelo ya pasó es de sólo lectura, como en la app — sólo su fecha o un estado de cierre; cualquier otra cosa es 409. Cada respuesta trae validation.
GET …/validation es la verificación de la propia app — Apéndice 2 del Doc 4444 de OACI, más la práctica argentina para planes en Argentina: cada observación con su casilla OACI, una severidad y el código del catálogo de la app; filable; y el mensaje FPL tal como se enviaría. Convenciones en Escribir en la cuenta.
{
"data": { "region": "AR", "filable": false,
"issues": [ { "field": "19", "severity": "error", "code": "flightPlan.issues.picRequired",
"message": "Pilot in command is required." } ],
"displayStatus": "draft", "editable": true, "expiresAt": "2026-10-10T14:33:00.000Z",
"message": "(FPL-LVABC-VG\n-C172/L-SDFGY/C\n-SADF1300\n-N0105A045 DCT FDO W5 ROS DCT\n-SAAR0133 SAAV\n-…)" },
"meta": { "requestId": "…", "generatedAt": "…" }
}Planificaciones
- GET
/v1/planningsPlanificaciones (paginadas) - GET
/v1/plannings/{id}Una planificación - POST
/v1/planningsCrear una planificación desde salida, ruta y destino (escritura) - PATCH
/v1/plannings/{id}Modificar una planificación (escritura) - DELETE
/v1/plannings/{id}Borrar una planificación (escritura) - GET
/v1/plannings/{id}/navlogSu navlog, calculado - POST
/v1/plannings/{id}/flight-planHacer el plan de vuelo OACI desde ella (escritura)
Cada ruta que el piloto armó en el mapa: los puntos en orden con su posición, la aeronave, la salida prevista, la altitud, el combustible a bordo, la reserva y el viento elegido, y el plan de vuelo en que se convirtió (flightPlanId). departure, destination y waypoints repiten lo que dice points. Primero el cambio más reciente.
| Parámetro | Significado |
|---|---|
limit · cursor · updatedSince | Paginación — ver Paginación y seguimiento de cambios. |
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/planningsEscritura
Los elementos de la ruta son un identificador ("PAL"), { ident, kind } cuando un código nombra dos cosas, { airway, to } por una aerovía publicada desde el punto anterior, o { lat, lon, name }. Un identificador que el EFB no conoce es 422 unknown_point, y una aerovía que no une los dos puntos, 422 not_on_airway: nunca se adivina.
El navlog se calcula al pedirlo y nunca se guarda: por tramo distancia, derrotas, declinación magnética, rumbo, velocidad sobre el terreno, tiempo, combustible y ETA; luego totales, reserva, autonomía y missing — lo que falta para obtener una cifra ausente. POST …/flight-plan convierte la planificación en un plan OACI como Crear plan de vuelo en la app: 201 con el borrador, su validation y el flightPlanId de la planificación. La secuencia completa está en Un plan de vuelo de punta a punta.
Planificaciones compartidas
- GET
/v1/shared-planningsPlanificaciones compartidas con un copiloto - GET
/v1/shared-plannings/{id}Una planificación compartida
Planificaciones que el piloto arma junto con un copiloto, como dueño o como invitado que aceptó. doc es lo que editan los dos; participants[].personal es la mitad propia de cada piloto — su aeronave, su combustible y el plan que hizo a partir de ella. Las claves de proveedores que se prestan nunca se guardan en la planificación ni se devuelven. Sólo lectura.
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/shared-planningsAerovías
- GET
/v1/airwaysRutas ATS (aerovías) del AIP Argentina
Las rutas ATS inferiores y superiores de Argentina como las dibuja la app, construidas a partir del AIP Argentina ENR 3.1, 3.2 y 4.4; source indica la edición de cada documento. Cada ruta trae sus puntos en el orden publicado y, por tramo, distancia, derrotas magnéticas, límites superior, inferior y mínimo y límites laterales — null donde la tabla del AIP no se leyó limpia. Verificá el ENR 3 antes del vuelo.
| Parámetro | Significado |
|---|---|
airspace | lower o upper; ambas si se omite. |
designator | Una sola ruta: W5, UL780. |
curl -s -H "Authorization: Bearer $ROGER_API_KEY" "https://api.rogeratc.app/v1/airways?designator=W5"Libro de vuelo
- GET
/v1/logbookAsientos del libro de vuelo (paginados) - GET
/v1/logbook/totalsHoras sumadas, en minutos - GET
/v1/logbook/exportEl libro de vuelo como archivo CSV - GET
/v1/logbook/{id}Un asiento - GET
/v1/logbook/{id}/attachments/{attachmentId}Enlace de descarga de una foto del asiento - POST
/v1/logbookCargar horas: un asiento nuevo (escritura) - PATCH
/v1/logbook/{id}Modificar un asiento (escritura) - PUT
/v1/logbook/{id}Reemplazar un asiento (escritura) - DELETE
/v1/logbook/{id}Borrar un asiento (escritura)
Cada vuelo del libro. La línea del libro de vuelo de ANAC (RAAC 61.120) está en log: las ocho celdas de tiempo de vuelo, la discriminación, el tiempo de simulador, los aterrizajes, las aproximaciones y el código de finalidad. Primero la log.date más reciente.
Las duraciones son minutos enteros: nunca horas decimales ni hh:mm. 90 es una hora y media; dale el formato que necesite tu servicio.
| Parámetro | Significado |
|---|---|
limit · cursor · updatedSince | Paginación — ver Paginación y seguimiento de cambios. |
from | Sólo para los totales. Primera log.date que se cuenta, AAAA-MM-DD, inclusive. Opcional. |
to | Sólo para los totales. Última log.date que se cuenta, inclusive. Opcional. |
format | Sólo para la exportación, obligatorio: anac-cad (la planilla de ANAC columna por columna; ANAC no publica un formato de importación para el CAD), easa, foreflight o generic-full (todos los campos). Responde text/csv, no JSON. |
zone | Sólo para la exportación: zona IANA en la que se escriben las horas de anac-cad (America/Argentina/Buenos_Aires). Por defecto UTC; EASA y ForeFlight siempre en UTC. |
delimiter | Sólo para la exportación: semicolon (coma decimal, Excel en español — por defecto en anac-cad) o comma. ForeFlight siempre comma. |
totals | Sólo para la exportación: true agrega una línea de totales (no en foreflight). Por defecto false. |
dateFormat | Sólo para la exportación: dmy (por defecto) o mdy, para las fechas de anac-cad y easa. Las demás son ISO. |
curl -s -H "Authorization: Bearer $ROGER_API_KEY" "https://api.rogeratc.app/v1/logbook?limit=100"Totales
curl -s -H "Authorization: Bearer $ROGER_API_KEY" \
"https://api.rogeratc.app/v1/logbook/totals?from=2026-01-01&to=2026-12-31"{
"data": {
"unit": "minutes", "from": "2026-01-01", "to": "2026-12-31",
"totals": {
"flight": 5130, "pilot": 5130, "copilot": 0, "day": 4800, "night": 330,
"local": 1200, "crossCountry": 3930, "instructorGiven": 0,
"instrumentReal": 0, "instrumentHood": 60, "multiEngine": 0,
"simulator": 120, "landings": 61, "entries": 38
},
"logged": {
"unit": "tenths", "total": 856, "crossCountry": 656, "local": 200,
"pilot": 856, "copilot": 0, "day": 801, "night": 55, "simulator": 20,
"instructorGiven": 0, "instrumentReal": 0, "instrumentHood": 10,
"multiEngine": 0, "landings": 61, "entries": 38
}
},
"meta": { … }
}data.logged son las cifras que muestra la pantalla del libro: las horas decimales de cada vuelo — sus celdas redondeadas a la décima más cercana (1:50 es 1,8), salvo que el piloto haya escrito su propia cifra (loggedTenths en la línea) —, sumadas de modo que crossCountry + local, pilot + copilot y day + night den siempre total. Van en décimas de hora ("unit": "tenths", enteros: 18 es 1,8 h). simulator va aparte y no suma al total. data.totals, en minutos, no cambió.
Se calcula con la misma función que la pantalla Libro de vuelo del EFB, así que no pueden discrepar. Las celdas de la discriminación desglosan horas ya contadas en las celdas de tiempo de vuelo y nunca se suman a flight; el tiempo de simulador no es tiempo de vuelo. Un vuelo sin línea de libro no se cuenta — entries dice cuántos se contaron — y una celda vacía cuenta como cero.
Escritura
El cuerpo es una línea del libro. date es obligatoria; kind es local (por omisión), crossCountry o simulator; role es pilot (por omisión) o copilot. Las celdas aceptan minutos enteros, o "1:45" y "1.75". La aeronave es aircraftId o el perfil cuya registration coincide. Se valida como la pantalla del libro valida una línea, y las advertencias de la app vuelven como warnings. Ejemplo en Cargar horas en el libro de vuelo.
Fotos
attachments en un asiento lista las fotos que el piloto asignó al vuelo (siempre kind: "photo", hasta doce). GET /v1/logbook/{id}/attachments/{attachmentId} (1.36.0) funciona como la de aeródromos: el adjunto más un enlace HTTPS firmado válido por 15 minutos, que se descarga sin la clave; 404 si el asiento no lista ese id o el archivo todavía no se subió. Las fotos se agregan y quitan sólo en la app, y borrar el asiento borra sus fotos.
Educación teórica
- GET
/v1/ground-schoolEl recorrido teórico y dónde está el piloto
Cada lección de la educación teórica (el curso de teoría del EFB), en el orden del recorrido, con el avance del piloto en cada una: status (notStarted, inProgress, completed), cuándo la empezó y la terminó, el paso en que está (position: intro, s:<section>, x:flashcards|practice|quiz, summary) y sus mejores puntajes en los ejercicios. summary las cuenta y next nombra la siguiente. Los id de lección son estables: una lección se agrega, nunca se renombra. title se lee igual que en la pantalla de la app, en los dos idiomas.
findings asocia cada hallazgo del debriefing de RogerATC con las lecciones que lo explican, de la más específica a la más general — la misma tabla que muestra el debriefing del EFB. Recomendá sólo lecciones con hasContent: true.
No se devuelve: el tiempo de estudio ni los días estudiados. Sólo lectura; el avance se mueve únicamente con los toques del piloto en la app.
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/ground-school{
"data": {
"summary": { "completed": 3, "inProgress": 1, "total": 154, "percent": 1 },
"next": "foundations.forcesAndMotion",
"lessons": [
{
"id": "foundations.cockpitArithmetic", "order": 0,
"level": "foundations", "category": "foundations",
"title": { "en": "Cockpit arithmetic: proportion, rates and tables",
"es": "Aritmética de cabina: proporciones, ritmos y tablas" },
"estimatedMinutes": 30, "hasContent": true, "prerequisites": [],
"status": "completed",
"startedAt": "2026-10-19T12:00:00.000Z",
"completedAt": "2026-10-19T12:41:00.000Z",
"lastActivityAt": "2026-10-19T12:41:00.000Z",
"position": "summary",
"exercises": {
"foundations.cockpitArithmetic/quiz": { "bestScore": 0.9, "passed": true, "attempts": 2 }
}
}
],
"findings": {
"fd-bank": ["aerodynamics.turnsAndLoadFactor", "foundations.forcesAndMotion"]
}
}
}Sesiones de tránsito
- GET
/v1/transit-plansPlanes de sesiones de tránsito instruidas (paginados) - GET
/v1/transit-plans/{id}Un plan de sesión de tránsito - GET
/v1/transit-runsEjecuciones de sesiones de tránsito informadas por el plugin (paginadas) - GET
/v1/transit-runs/{id}Una ejecución — el punto para retomar si X-Plane se cerró
Una sesión de tránsito instruida (1.38.0) es una sesión de entrenamiento paso a paso que el piloto planifica en Copilot EFB y vuela en X-Plane con RogerATC: el controlador da una parte del plan, el piloto la vuela y notifica, y el controlador da la siguiente. Dos registros, cada uno con un solo autor.
transitPlan es lo que armó el piloto: la aeronave, las reglas de vuelo, salida y destino, hasta 60 pasos en orden —cada uno una acción (la autorización de tránsito, una fase del vuelo, una de las instrucciones de la consola o una maniobra del instructor), quién la da, cómo termina (colación, una notificación o una medición), vueltas de espera, mínimos de aproximación y objetivos— y la configuración de emergencias y pedidos de posición. Primero el editado más recientemente. No hay ruta de escritura: sólo el piloto cambia lo que una sesión le pide volar.
transitRun es una ejecución, escrita por el servidor a partir del PUT /v1/plugin/transit-runs/{id} del plugin: el estado, el avance de cada paso con lo que se dijo y lo que se midió (una medición no tomada es null, nunca 0), las interrupciones (pedidos de posición, emergencias) y la transcripción, hasta 600 líneas archivadas por paso (transcriptDropped cuenta el resto). Primero el startedAt más reciente.
| Parámetro | Significado |
|---|---|
limit · cursor · updatedSince | Paginación. updatedSince es la forma de seguir una ejecución en curso. |
Borrar una sesión en la app borra el plan y cada una de sus ejecuciones: los dos responden 404 acá, y el siguiente PUT del plugin para una de sus ejecuciones responde 410.
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/transit-plans/PLAN_ID
curl -s -H "Authorization: Bearer $ROGER_API_KEY" "https://api.rogeratc.app/v1/transit-runs?limit=5"Perfil del piloto
- GET
/v1/pilotEl perfil del piloto
Nombre, teléfono, licencias, habilitaciones con su vencimiento y certificado médico — o data: null si el piloto no creó un perfil. Es el mismo perfil que muestra el EFB, y lo más sensible que puede leer la clave.
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/pilotPlugin RogerATC AI
RogerATC AI, el plugin de ATC por voz para X-Plane 12, se vincula con la cuenta de Copilot EFB del piloto mediante esta clave: se activa con ella en cada arranque, trae las claves de proveedores que el piloto guarda en el EFB, envía un resumen de cada sesión de simulador — siempre las estadísticas, y el registro de eventos si el piloto lo elige — y, con el enlace en vivo encendido, informa su estado y recoge las instrucciones del instructor. El EFB guarda las sesiones en la cuenta, así que aparecen en cada dispositivo donde el piloto inició sesión.
Con la misma clave el plugin lee lo que el piloto ya tiene en el EFB, mediante los endpoints de arriba, y los mensajes sin leer del piloto, que su instructor lee en voz alta. Ninguna ruta del plugin necesita el permiso de escritura.
RogerATC AI está en beta pública. Esta sección es el contrato sobre el que está construido su enlace con el EFB.
Activación
- POST
/v1/plugin/activationLa verificación de licencia de RogerATC: la cuenta y los nombres de sus claves
Lo llama el plugin en cada arranque (client: "core") y RogerATC Setup cuando el piloto vincula o prueba la clave (client: "setup"). Una clave válida de una cuenta no pausada es la licencia. La respuesta dice de quién es la cuenta y qué claves de proveedores tiene — nunca sus valores. El cuerpo es de 8 KB como máximo; una cuenta pausada es 403 account_suspended.
curl -s -X POST https://api.rogeratc.app/v1/plugin/activation \
-H "Authorization: Bearer $ROGER_API_KEY" -H "Content-Type: application/json" \
-d '{ "schema": 1, "client": "setup", "installId": "9f1c2d3e-0000", "pluginVersion": "1.3.0-beta",
"os": "macos", "arch": "arm64" }'{
"schema": 1, "ok": true,
"account": { "id": "…", "name": "A. Pilot", "email": "pilot@example.com" },
"credentials": { "available": ["openai", "openaip"] },
"serverTime": "2026-10-09T13:00:00.000Z",
"data": { "…": "the same object, in the usual envelope" },
"meta": { "requestId": "…", "generatedAt": "…" }
}Claves de proveedores
- GET
/v1/plugin/credentialsLas claves de proveedores que usa RogerATC, desde los Ajustes del piloto
Las claves que el piloto cargó en Copilot EFB → Ajustes → Claves que usa RogerATC: openai (obligatoria), openaip, windy, flightradar24, tavily y, desde la 1.25.0, anthropic, xai y openrouter — las propias claves del asistente, para el piloto que elige una de ellas como modelo de lenguaje de RogerATC. Un plugin conserva sólo los nombres que conoce. Sólo se devuelven las presentes, con Cache-Control: no-store. El servidor registra que se pidieron y qué nombres — nunca un valor. Cada clave va sólo a su propio proveedor; RogerATC la guarda en el llavero del sistema.
Calificación de turnos
- GET
/v1/plugin/feedbackLas calificaciones de un administrador a turnos de RogerATC, como conjunto de entrenamiento - POST
/v1/plugin/feedback/appliedMarcar calificaciones incorporadas en una versión del plugin
Desde la 1.22.0. Un administrador califica turnos de RogerATC en la app, sobre la transcripción de una sesión en vivo o archivada; así es como el lado del plugin lee esas calificaciones y dice que aprendió de ellas. Un turno es una transmisión del piloto y todo lo que le respondió. Cada ejemplo trae las líneas del turno, su contexto (idioma, región, versión del plugin, aeronave, aeródromo, estación, la intención y la plantilla reconocidas), la calificación —up, o down con una corrección y su alcance—, una revisión opcional de un modelo y su estado.
GET /v1/plugin/feedback, con status = pending (por defecto), applied o all, responde el conjunto; con cualquier clave, y sólo la cuenta de un administrador tiene calificaciones, así que cualquier otra recibe uno vacío. POST /v1/plugin/feedback/applied con { "ids": […], "version"?, "note"? } (hasta 200 ids) las marca incorporadas y necesita una clave con permiso de escritura (si no, 403 insufficient_scope). Las dos con Cache-Control: no-store.
Mensajes
- GET
/v1/plugin/messagesLos mensajes sin leer del piloto, para que el instructor los lea en voz alta - POST
/v1/plugin/messages/{id}/readMarcar uno como leído, en todos los dispositivos
La bandeja de entrada sin leer del piloto, de la más antigua a la más reciente: el nombre de quien escribe — nunca una dirección —, si vino de un administrador o para todos, un asunto opcional, el cuerpo cortado a 1.000 caracteres y cuándo se envió. unread los cuenta todos. Nada más de los mensajes está en la API: ni copias enviadas, ni hilos, ni envío.
| Parámetro | Significado |
|---|---|
limit | De 1 a 20, 10 por omisión. |
POST …/read marca uno como leído igual que abrirlo en la app, en todos los dispositivos. Responde 204 sin cuerpo — también si ya estaba leído — y 404 para cualquier cosa que no sea la bandeja de este piloto.
curl -s -H "Authorization: Bearer $ROGER_API_KEY" "https://api.rogeratc.app/v1/plugin/messages?limit=10"
curl -s -X POST -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/plugin/messages/MESSAGE_ID/read{
"data": [ { "id": "6f1c…", "from": "A. Copilot", "fromAdministrator": false, "broadcast": false,
"body": "Tomorrow 1330Z from SADF, let me know if you are coming.",
"sentAt": "2026-10-09T14:03:00.000Z" } ],
"unread": 3,
"meta": { "requestId": "…", "generatedAt": "…" }
}Guardar una sesión
- PUT
/v1/plugin/sessions/{id}Guardar una sesión de RogerATC AI
Un upsert idempotente de una sesión completa. Se envía al comenzar, en un punto de control cada pocos minutos si algo cambió, y una vez al terminar: siempre la sesión entera, siempre con el mismo id. Reintentar después de una conexión caída no causa ningún problema.
| Parámetro | Significado |
|---|---|
{id} | El id de sesión del plugin, estable durante todo el vuelo: de 3 a 128 caracteres entre A–Z a–z 0–9 . _ -, empezando por una letra o un dígito. |
PUT /v1/plugin/sessions/5f0c2a4e-7d1b-4c6a-9d0e-2b8f1c3a6e77 HTTP/1.1
Host: api.rogeratc.app
Authorization: Bearer rat_live_…
Content-Type: application/json{
"schema": 1,
"status": "completed",
"startedAt": "2026-09-17T18:02:11Z",
"endedAt": "2026-09-17T19:14:40Z",
"pluginVersion": "0.4.0",
"protocolVersion": "1",
"simulator": "X-Plane 12.1.4",
"language": "es",
"region": "AR",
"dataSource": "both",
"aircraft": { "registration": "LV-XXX", "icaoType": "C172" },
"departure": "SADF",
"arrival": "SAAR",
"aerodromesVisited": ["SADF", "SAAR"],
"stats": {
"transmissions": 42, "fastPath": 30, "modelCalls": 12, "sayAgain": 2,
"readbacksCorrect": 17, "readbacksIncorrect": 1, "positionCorrections": 0,
"unprompted": 4, "emergencies": 0, "instructorQuestions": 3,
"meanResponseMs": 1850, "p95ResponseMs": 3400,
"byStation": { "ground": 9, "tower": 14, "approach": 11, "centre": 8 },
"byIntent": { "request_taxi": 2, "ready_departure": 1, "position_report": 6 }
},
"events": [
{
"at": "2026-09-17T18:04:02Z", "kind": "turn",
"station": "San Fernando Superficie", "intent": "request_taxi", "template": "taxi-clearance",
"heard": "San Fernando superficie, LV-XXX en plataforma, solicito rodaje",
"said": "LV-XXX, ruede a punto de espera pista 05, QNH 1018"
}
]
}Campos del cuerpo
| Campo | Obligatorio | Reglas |
|---|---|---|
schema | sí | 1. |
startedAt | sí | ISO 8601. No más de un día en el futuro. |
endedAt | no | ISO 8601, o null mientras se vuela. |
status | no | in_progress, completed o aborted. Si falta: completed cuando hay endedAt, y si no in_progress. |
pluginVersion, protocolVersion, simulator, language, region | no | Cadenas cortas, sin espacios sobrantes. En language y region se normaliza el uso de mayúsculas. |
dataSource | no | sim, both o efb: de dónde tomó el plugin los datos de aeródromo. Cualquier otro valor se guarda como null. |
aircraft | no | { registration, icaoType }, en mayúsculas. |
departure, arrival | no | Un identificador de aeródromo: 3 o 4 caracteres A–Z 0–9 (OACI, o un código nacional cuando no hay). Cualquier otro valor se guarda como null. |
aerodromesVisited | no | Hasta 20 identificadores, sin repetidos. |
stats | no | Los diez contadores del ejemplo, enteros y no negativos (cualquier otro valor cuenta como 0); meanResponseMs y p95ResponseMs o null; byStation hasta 30 claves y byIntent hasta 60, con claves que cumplan [a-z0-9][a-z0-9_.-]{0,39}, conservando las mayores. |
events | no | Sólo con el registro de eventos activado. Hasta 200, se conservan los más recientes. kind: turn, unprompted, silence, error o instructor; at obligatorio; station, intent, template; heard se corta en 160 caracteres y said en 240. Los eventos de un tipo desconocido o sin un at válido se descartan. |
eventsDropped | no | Lo que el plugin ya descartó antes de enviar; se suma a la cuenta del servidor. |
aiUsage | no | El uso de IA de la sesión, acumulado, una línea por proveedor, modelo y tipo (llm, stt, tts, search), como máximo 40: solicitudes, tokens, segundos de audio — los conteos del propio proveedor, nunca estimados. El EFB les pone precio para que el piloto vea cuánto gastan sus propias claves. Reenviar un resumen nunca cuenta dos veces. |
Cualquier otra cosa en el cuerpo se ignora y no se guarda. En una sesión no va nada derivado del escenario ni de los datos de navegación de X-Plane, ni audio, ni claves de proveedores.
Límites
- El cuerpo pesa como máximo 512 KB; por encima,
413. - La sesión guardada ocupa como máximo 200 KB: se quitan los eventos más antiguos hasta que entre, y
eventsDroppedlos cuenta. - Un registro por sesión, nunca uno por cada comunicación.
Respuestas
| Estado | Cuerpo | Significado |
|---|---|---|
201 | { id, status, receivedAt, eventsStored, eventsDropped } | La primera vez que se guarda este id. |
200 | el mismo | Se reemplazó la copia guardada. createdAt se conserva desde la primera llegada. |
400 | error | Un campo no cumple una de las reglas anteriores; el mensaje lo nombra. |
410 | error gone | El piloto eliminó esta sesión en el EFB. Dejá de enviarla: no se volverá a guardar. |
413 · 415 | error | Demasiado grande, o no es JSON. |
401 · 429 | error | La clave, el límite de solicitudes, o el cupo de 50 sesiones nuevas por día UTC. Un PUT cada pocos minutos con el mismo id queda muy dentro de ambos. |
curl -s -X PUT \
-H "Authorization: Bearer $ROGER_API_KEY" \
-H "Content-Type: application/json" \
--data @session.json \
https://api.rogeratc.app/v1/plugin/sessions/5f0c2a4e-7d1b-4c6a-9d0e-2b8f1c3a6e77HTTP/1.1 201 Created
{
"data": {
"id": "5f0c2a4e-7d1b-4c6a-9d0e-2b8f1c3a6e77",
"status": "completed",
"receivedAt": "2026-09-17T19:14:42.018Z",
"eventsStored": 1,
"eventsDropped": 0
},
"meta": { … }
}La parte del plugin en el contrato
- El simulador nunca espera a la API. Las solicitudes salen de una cola en disco, en segundo plano, con un tiempo de espera corto y reintentos espaciados, fuera de los hilos de audio y del simulador. Un error, un tiempo agotado o la falta de red son silencio; nunca un simulador detenido.
401significa que la clave se rotó o la cuenta se pausó: se deja de enviar y se avisa al piloto una sola vez.410significa que el piloto eliminó esa sesión: se quita de la cola y no se vuelve a enviar.429significa esperar lo que indicaRetry-Afterantes del próximo intento.
Enlace en vivo
- PUT
/v1/plugin/liveInforma el estado en vivo y recoge las instrucciones pendientes
Mientras el piloto vuela con el enlace en vivo activado en el plugin (efb_live = on, desactivado por defecto), el plugin llama a esta ruta cada pocos segundos con su estado medido — posición, altitud, velocidades, rumbo, en tierra o en vuelo, COM1, transpondedor, QNH, viento — y con el resultado de cada instrucción que atendió. La respuesta trae las instrucciones que el instructor dejó en la consola RogerATC del EFB, y cuánto esperar antes de volver a llamar (pollMs).
No es un registro sincronizado: el estado se sobrescribe en cada llamada y el servidor lo olvida a los diez minutos. Nunca se guarda una trayectoria. Las radioayudas, frecuencias y pistas no viajan: salen de los datos de navegación del simulador, cuya licencia prohíbe que dejen la máquina del piloto, y el EFB los calcula con su propia base pública.
Cada instrucción se entrega una sola vez. Una que el plugin no recogió en dos minutos caduca y nunca se entrega tarde. El plugin responde en el siguiente informe con spoken y el texto exacto que dijo el controlador, o con refused y un motivo (on_ground, unknown_navaid, no_dme…). El motor del plugin redacta cada palabra; el EFB sólo la pide.
Desde 1.38.0 la respuesta también trae transit: la sesión de tránsito armada —{ planId, armedAt, runId }— o null (nada armado, un armado sin tocar por 24 horas, o uno cuyo plan se borró). El plan se lee con GET /v1/transit-plans/{id} y no se dice nada hasta que el piloto pide el tránsito; runId con valor significa que una ejecución ya empezó: se lee con GET /v1/transit-runs/{id} y se retoma desde currentStepIndex. Tres tipos de instrucción controlan la sesión desde el EFB: transitSkip { runId, stepId } (termina el paso activo y da el siguiente), transitAbort { runId } (termina la sesión y restaura todo lo inyectado) y transitEmergency { runId, emergency } (inyecta una emergencia ahora). Un plugin sin sesiones de tránsito las rechaza con not_supported.
curl -X PUT https://api.rogeratc.app/v1/plugin/live \
-H "Authorization: Bearer $COPILOT_EFB_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "schema": 1, "sessionId": "2026-10-03_1415", "sentAt": "2026-10-03T14:15:02Z",
"aircraft": { "registration": "LV-XXX", "icaoType": "C172" },
"sim": { "paused": false, "phase": "cruise", "onGround": false,
"latDeg": -34.6, "lonDeg": -58.7, "altitudeFt": 2500, "headingMagDeg": 270,
"groundspeedKt": 95, "verticalSpeedFpm": 0, "…": "…" },
"aerodrome": { "ident": "SADF", "activeRunway": "05" },
"transcript": [], "acks": [] }'{
"data": {
"commands": [
{ "id": "1759500902000-x7Kq2m9A", "createdAt": "2026-10-03T14:15:00Z",
"request": { "kind": "holding", "navaid": "SFD", "inboundCourseDeg": 50,
"turn": "right", "legMinutes": null, "altitudeFt": 2500 } }
],
"pollMs": 2000,
"transit": { "planId": "3f0c…", "armedAt": "2026-10-21T13:55:00.000Z", "runId": null }
}
}Guardar una ejecución de tránsito
- PUT
/v1/plugin/transit-runs/{id}Guarda una ejecución de una sesión de tránsito instruida
La escritura del plugin: un upsert idempotente de una ejecución entera —al empezar, cada vez que avanza un paso, en cada interrupción y al terminar— con el mismo id (3 a 128 de A–Z a–z 0–9 . _ -). El cuerpo es una ejecución, schema: 1, de hasta 400 KB; los campos desconocidos se descartan, currentStepIndex se limita a los pasos enviados y las líneas más viejas de la transcripción se van pasadas las 600 o los 250 KB.
{
"schema": 1,
"planId": "3f0c…",
"planUpdatedAt": "2026-10-21T12:00:00.000Z",
"status": "in_progress",
"startedAt": "2026-10-21T14:00:00.000Z",
"currentStepIndex": 1,
"steps": [
{ "stepId": "s0a1b2c3d4e", "status": "done", "issuedAt": "…", "completedAt": "…", "completedBy": "readback",
"said": "LV-XXX autorizado a San Fernando…", "metrics": { "durationS": 42, "samples": 42, "readbackCorrect": true } },
{ "stepId": "s9z8y7x6w5v", "status": "active", "issuedAt": "…" }
],
"interrupts": [],
"transcript": [{ "at": "…", "who": "atc", "station": "Morón Torre", "text": "…", "stepId": "s0a1b2c3d4e" }]
}| Estado | Significado |
|---|---|
201 · 200 | Guardada (la primera vez / después). data: { id, status, receivedAt, currentStepIndex }. |
400 | Un cuerpo o un id malformado, o un planId distinto del que tenía la ejecución al empezar. |
409 not_armed | Una ejecución nueva de un plan que el piloto no armó. Una ejecución empieza sólo después de que el piloto toca Listo; el transit de la respuesta en vivo nombra el plan armado. Volver a enviar una ejecución existente nunca necesita el armado. |
410 gone | El piloto borró esta ejecución, o su plan falta o fue borrado. Terminá la sesión y no la vuelvas a enviar. |
429 rate_limited | Más de 20 ejecuciones nuevas en un día UTC, o más de 3.000 escrituras de una misma ejecución (queda como se guardó por última vez). |
El primer PUT anota la ejecución en el armado (transit.runId), cada PUT mientras está in_progress renueva el armado por 24 horas, y completed o aborted lo libera. Una ejecución completed o aborted es definitiva: un PUT posterior responde 200 con lo guardado y no cambia nada.
curl -s -X PUT -H "Authorization: Bearer $ROGER_API_KEY" -H "Content-Type: application/json" \
--data @run.json https://api.rogeratc.app/v1/plugin/transit-runs/RUN_IDLeer sesiones
- GET
/v1/plugin/sessionsSesiones de RogerATC AI (paginadas) - GET
/v1/plugin/sessions/{id}Una sesión de RogerATC AI
Cada sesión guardada, primero el startedAt más reciente, tal como se guardó: los campos del cuerpo más id, source (rogeratc-plugin), durationMinutes (del inicio al fin, o hasta la última llegada mientras sigue en curso), eventsDropped, receivedAt, createdAt y updatedAt.
| Parámetro | Significado |
|---|---|
limit · cursor · updatedSince | Paginación. updatedSince es la forma de seguir las sesiones que siguen en curso. |
curl -s -H "Authorization: Bearer $ROGER_API_KEY" \
"https://api.rogeratc.app/v1/plugin/sessions?updatedSince=2026-09-17T18:00:00Z"Totales
- GET
/v1/plugin/statsTotales de todas las sesiones de RogerATC AI
Los mismos totales que muestra la pantalla RogerATC AI del EFB. minutes es la suma de durationMinutes de todas las sesiones. meanResponseMs se pondera por las transmisiones de cada sesión, y es null cuando no se midió nada.
curl -s -H "Authorization: Bearer $ROGER_API_KEY" https://api.rogeratc.app/v1/plugin/stats{
"data": {
"sessions": 12,
"byStatus": { "in_progress": 0, "completed": 11, "aborted": 1 },
"minutes": 842, "transmissions": 506,
"readbacksCorrect": 201, "readbacksIncorrect": 9,
"sayAgain": 14, "emergencies": 1, "instructorQuestions": 37,
"meanResponseMs": 1910,
"firstStartedAt": "…", "lastStartedAt": "…",
"byStation": { "tower": 180, "ground": 120, "approach": 110, "centre": 96 },
"aerodromes": [{ "ident": "SADF", "sessions": 9 }],
"aircraft": [{ "label": "LV-XXX", "sessions": 10 }]
},
"meta": { … }
}Versiones y cambios
Las rutas llevan la versión mayor. Las rutas nuevas, los campos nuevos y los valores nuevos de status se suman y quedan en /v1, así que un cliente debe ignorar lo que no reconoce. Todo lo que rompería a un cliente que sigue esta página va a una versión mayor nueva, y /v1 se mantiene hasta que sus usuarios hayan migrado.
| Versión | Fecha | Cambio |
|---|---|---|
1.50.0 | 2026-11-20 | El perfil del piloto puede traer bloodGroup y emergencyContacts, y una planificación aircraftRegistration para una aeronave que no está en la flota. Los registros se devuelven enteros, así que ninguna ruta cambia. Aditivo. |
1.49.0 | 2026-11-20 | Un comando dmeArc puede traer joinRadialDeg, el radial por el que se ingresa al arco (revisión 3 del enlace en vivo); el reporte del plugin suma los datos de motores a turbina: tipo de motor, N1, N2, ITT, torque, APU, aviso de fuego e hidráulica (protocolo v24). Todo aditivo. |
1.48.0 | 2026-11-19 | Las fichas de aeródromo pueden traer activities (planeadores, paracaidismo, aeromodelismo, drones) y /v1/aerodrome-knowledge las lista en card.activities. Los comandos y pasos de tránsito aceptan la inversión procedureTurn90 (90°/270°, de entrenamiento, no OACI) y las métricas de un paso suman la espera volada (entrada, tramos, velocidad máxima). El reporte en vivo trae linkVersion: un comando recibido en pausa queda held y puede cancelarse; el comando transitRefresh, los planes pool: true, el rev de cada paso y el estado abandoned forman la cola de entrenamiento. Aditivo. |
1.47.0 | 2026-11-19 | GET /v1/aerodrome-knowledge suma dos bloques: ils, los ILS que publica el AIP argentino (AD 2.19) por pista —identificación, frecuencias del localizador y de la senda, categoría, ángulo, altura de referencia y canal DME— con el documento, su edición y su fecha; y areaWeather, la FIR del aeródromo y los SIGMET vigentes en ella. Aditivo. |
1.46.0 | 2026-11-18 | Un plan de sesión de tránsito (GET /v1/transit-plans) puede traer pilotLevel: "novice" (ausente: experto), y la salida y el destino pueden ser el mismo aeródromo: una sesión local. Aditivo. |
1.45.0 | 2026-11-17 | GET /v1/pilot devuelve simbriefUsername, el alias de SimBrief del piloto cuando lo cargó (no es un secreto). Un plan importado de SimBrief trae la ruta en routeOverride con la SID primero y la STAR al final. Aditivo. |
1.44.0 | 2026-11-14 | PUT /v1/plugin/live acepta nueve campos del protocolo v23 de RogerATC: la bandera TO/FROM del NAV1, el rumbo a la estación, las agujas de curso y de senda, el ADF1, la fuente y las agujas del HSI, y el tramo del GPS. Aditivo. |
1.43.1 | 2026-11-13 | GET /v1/weather y el bloque de clima de /v1/aerodrome-knowledge: si NOAA falla, se sigue respondiendo el METAR o TAF que la API ya tenía, con el fetchedAt de cuando se obtuvo, y NOAA no se vuelve a consultar por un minuto. Sin cambio de forma. |
1.43.0 | 2026-11-06 | PUT /v1/plugin/live acepta dieciséis campos del protocolo v22 de RogerATC (acelerador, palanca de la hélice y presión de admisión por motor, cabina, calefacción del pitot y hielo, indicador de rumbo, brújula y succión, director de vuelo y modos del piloto automático, tren); sim.temperatureC y dewpointC son los del aire en el avión. Nuevo hallazgo de debriefing fd-pitot-heat-icing. Aditivo. |
1.42.0 | 2026-11-04 | PUT /v1/plugin/live acepta sim.engineCount, engineRunning, propRpm y rudderRatio (protocolo v21 de RogerATC). Aditivo. |
1.41.0 | 2026-10-28 | El debriefing de la sesión puede traer dos hallazgos nuevos: fd-squawk-mismatch (assigned, seconds) y fd-transponder-standby (seconds). Aditivo. |
1.40.0 | 2026-10-28 | PUT /v1/plugin/live acepta sim.rollDeg, pitchDeg, slipDeg, turnRateDegPerSec y loadFactorG (protocolo v20 de RogerATC). Las sesiones de tránsito suman maniobras, técnicas de despegue y aterrizaje, stopAndGo, la emergencia partialPower, el rechazo unsupported y métricas nuevas por paso. Aditivo. |
1.39.0 | 2026-10-27 | PUT /v1/plugin/live acepta sim.trackTrueDeg, sim.fuelFlowKgPerHour y sim.maxTakeoffMassKg (protocolo v19 de RogerATC). Aditivo. |
1.38.0 | 2026-10-21 | GET /v1/transit-plans, /v1/transit-plans/{id}, /v1/transit-runs y /v1/transit-runs/{id} — las sesiones de tránsito instruidas y sus ejecuciones. PUT /v1/plugin/transit-runs/{id}, la escritura del plugin, con el código nuevo 409 not_armed. PUT /v1/plugin/live responde transit. Nuevos tipos de instrucción transitSkip, transitAbort y transitEmergency. Aditivo. |
1.37.0 | 2026-10-19 | GET /v1/ground-school — las lecciones de la educación teórica y el avance del piloto en cada una, con las lecciones que explican cada hallazgo del debriefing, para el instructor de RogerATC. No devuelve tiempo ni días de estudio. Aditivo. |
1.36.0 | 2026-10-17 | GET /v1/aerodrome-knowledge/{ident}: un código bien formado que ninguna fuente conoce es 200 con known: false, no 404; nuevos known y world. GET /v1/logbook/{id}/attachments/{attachmentId} para las fotos de un asiento. Los comentarios suman subject, file y hasFile. PUT /v1/plugin/live acepta sim.cloudLayers. Borrar un registro borra los archivos que listaba. Aditivo. |
1.35.0 | 2026-10-16 | GET /v1/aerodrome-knowledge/{ident}: reference suma use, controlled, classificationSource, classificationAsOf y codePair; las fichas de aeródromo pueden traer use y controlled. Aditivo. |
1.34.0 | 2026-10-16 | Los comentarios de aeródromo suman thumbUrl, siempre null acá como photoUrl. Aditivo. |
1.33.0 | 2026-10-16 | GET /v1/aerodrome-comments/{ident} — los comentarios aprobados de pilotos sobre un aeródromo, más los propios de esta cuenta. Las planificaciones aceptan escalas de combustible (refuel, refuelFuel); el log de navegación suma segments; POST /v1/plannings/{id}/flight-plan acepta leg. Aditivo. |
1.32.0 | 2026-10-15 | GET /v1/logbook/export: en EASA y ForeFlight la columna de fecha es la fecha UTC de la hora fuera de calzos. PATCH/PUT /v1/logbook/{id} conservan el origin de un renglón importado. Una corrección y un agregado. |
1.31.0 | 2026-10-15 | GET /v1/logbook/export?format= devuelve el libro de vuelo como CSV con la misma función que la pantalla: anac-cad (la planilla de ANAC columna por columna; ANAC no publica un formato de importación para el CAD), easa, foreflight o generic-full (todos los campos). Los renglones pueden traer log.origin (importado de una foto o de un CSV). Aditivo. |
1.30.0 | 2026-10-15 | Los perfiles de aeronave pueden traer landingDistance y su unidad, y el peso para el que valen las distancias del POH (takeoffDistanceWeight, landingDistanceWeight). Aditivo. |
1.29.0 | 2026-10-15 | El feedback de turnos admite una nota en un pulgar arriba (confirmation), conserva la corrección al cambiar de calificación y cuenta pendientes y aplicadas por tipo (counts.byRating). Los perfiles pueden traer maxFuelImbalanceKg y fuelReserveMinutes; el debriefing suma cuatro hallazgos. Aditivo. |
1.28.0 | 2026-10-15 | Un interruptor por cuenta para que RogerATC lea o no las claves de proveedores: apagado, GET /v1/plugin/credentials responde 403 credentials_disabled y la activación trae credentials.allowed: false. Aditivo. |
1.27.0 | 2026-10-14 | PUT /v1/plugin/sessions/{id} acepta un debrief opcional — el debriefing del copiloto: minutos en el aire, despegues, aterrizajes y hallazgos ordenados por seguridad con sus números —, guardado en la sesión. Los perfiles de aeronave pueden traer speeds.v1, flapRetractionHeightFt y turnbackMinimumAglFt, que lee el briefing de despegue. Aditivo. |
1.26.0 | 2026-10-14 | PUT /v1/plugin/live devuelve serverTime, para medir la edad de un comando con el reloj del servidor, y un comando llega sólo a la sesión en la que se envió. Los ejemplos de feedback de turnos traen updatedAt, y POST /v1/plugin/feedback/applied acepta seen y responde changed: una calificación editada desde que se leyó queda pendiente. En un mismo instante, la transmisión del piloto se ordena antes que su respuesta. La activación devuelve email siempre como texto. Aditivo. |
1.25.0 | 2026-10-14 | GET /v1/plugin/credentials también devuelve anthropic, xai y openrouter — las propias claves del asistente — para que RogerATC 1.9 beta elija su modelo de lenguaje, y credentials.available de la activación las nombra. Aditivo. |
1.24.0 | 2026-10-13 | Fichas de aeródromo: frequencies.tma, una lista de { id, name, frequency } con el nombre que pone el piloto, reemplaza a los fijos tma1…tma5; las escrituras la aceptan y pliegan en ella los campos viejos; las frecuencias de área de /v1/aerodrome-knowledge traen el name del piloto. Aditivo. |
1.23.0 | 2026-10-12 | PUT /v1/plugin/sessions/{id}: stats puede traer retries, standbys y callbacks; GET /v1/plugin/stats los suma. Aditivo. |
1.22.0 | 2026-10-12 | GET /v1/plugin/feedback y POST /v1/plugin/feedback/applied — las calificaciones de turnos de un administrador como conjunto de entrenamiento. Aditivo. |
1.21.0 | 2026-10-12 | Las escrituras del libro de vuelo aceptan simulatorDevice, simulatorClass, manoeuvres y manoeuvresOther de una sesión de simulador. Aditivo. |
1.20.0 | 2026-10-12 | Las planificaciones compartidas admiten hasta tres invitados, cada uno viewer o editor; cada participante trae access. Aditivo. |
1.19.0 | 2026-10-12 | GET /v1/aerodrome-knowledge/{ident} — la ficha del piloto, la referencia de OurAirports, el MADHEL y los NOTAM de ANAC y la meteorología de un aeródromo, cada uno con su fuente y su fecha; GET /v1/aerodrome-knowledge — aeródromos y frecuencias de TMA del piloto alrededor de una posición. Solo lectura, sin cambios en lo existente. |
1.18.0 | 2026-10-09 | Escritura, con una clave a la que el piloto le permitió escribir: asientos del libro (cargar horas), aeronaves, fichas de aeródromo, notas, checklists, planificaciones y planes de vuelo; GET /v1/plannings/{id}/navlog, POST /v1/plannings/{id}/flight-plan, GET /v1/flight-plans/{id}/validation. Idempotency-Key, ETag e If-Match. Códigos de error nuevos insufficient_scope, conflict, precondition_failed, unprocessable, unavailable. 1.000 escrituras por cuenta y por día. |
1.17.0 | 2026-10-09 | GET /v1/plugin/messages y POST /v1/plugin/messages/{id}/read: la bandeja sin leer, para que el instructor de RogerATC la lea en voz alta. Las sesiones del plugin aceptan aiUsage. Aditivo. |
1.16.0 | 2026-10-08 | Enlace en vivo: veinte campos medidos opcionales — el reglaje del altímetro, las capas de viento, COM2 y frecuencias en espera, combustible y peso, flaps, tren, piloto automático, el tránsito del simulador. Una ruta mal codificada responde 400 en vez de 500. Una sesión rechazada ya no gasta el cupo diario. |
1.15.0 | 2026-10-07 | POST /v1/plugin/activation (la verificación de licencia de RogerATC) y GET /v1/plugin/credentials (las claves de proveedores que usa). Código de error nuevo account_suspended, sólo en esas dos rutas. Aditivo. |
1.14.0 | 2026-10-06 | Enlace en vivo: diez tipos de instrucción IFR — marcación, directo, aproximación, vectores, circuito, cambio de pista, aproximación frustrada, salida, llegada, desvío — y opciones nuevas de espera y de inversión de rumbo. Aditivo. |
1.13.0 | 2026-10-06 | Las aerovías traen segments: derrotas, límites y nivel mínimo por tramo. Un punto de planificación puede ser sólo una posición. Aditivo. |
1.12.0 | 2026-10-05 | GET /v1/shared-plannings, GET /v1/shared-plannings/{id} y GET /v1/airways. Un punto de planificación puede ser un punto significativo y nombrar la aerovía por la que se llega a él. Aditivo. |
1.11.0 | 2026-10-03 | GET /v1/plannings y GET /v1/plannings/{id}: las rutas planificadas en el mapa. Un plan de vuelo hecho desde una planificación lleva planningId. Aditivo. |
1.10.0 | 2026-10-03 | PUT /v1/plugin/live: el enlace en vivo de RogerATC AI — el estado medido del simulador y las instrucciones del instructor. La segunda escritura de la API, con estado que caduca y no se sincroniza. Aditivo. |
1.9.0 | 2026-09-24 | /v1/logbook/totals agrega data.logged, las horas decimales en décimas que muestra la pantalla del libro. Las líneas pueden llevar loggedTenths. Aditivo. |
1.8.0 | 2026-09-22 | Los planes de vuelo llevan signatureDataUrl, la firma de ese plan. Los vuelos de checklists llevan autoClosed. Aditivo. |
1.7.0 | 2026-09-19 | Las aeronaves llevan attachments — manuales, documentos y fotos — y GET /v1/aircraft/{id}/attachments/{attachmentId} da un enlace de descarga temporal. Límite por archivo: 100 MB. Aditivo. |
1.6.0 | 2026-09-18 | Vuelos de checklists: GET /v1/check-flights y GET /v1/check-flights/{id}. Aditivo. |
1.5.0 | 2026-09-18 | Las fichas de aeródromo llevan aids (radioayudas y ayudas visuales) y fuel.products (aceites y aditivos). Aditivo. |
1.4.0 | 2026-09-18 | Las fichas de aeródromo llevan attachments, y GET /v1/aerodromes/{id}/attachments/{attachmentId} da un enlace de descarga temporal. Aditivo. |
1.3.1 | 2026-09-17 | Revisión de seguridad: permisos mínimos para la API, un tope diario de sesiones nuevas del plugin, y reiniciar una cuenta rota su clave. |
1.3.0 | 2026-09-17 | Las fichas de aeródromo llevan fuel. Aditivo. |
1.2.0 | 2026-09-17 | Checklists: GET /v1/checklists y GET /v1/checklists/{id}. Sesiones del plugin RogerATC AI: PUT /v1/plugin/sessions/{id} (la primera escritura), GET /v1/plugin/sessions, GET /v1/plugin/sessions/{id} y GET /v1/plugin/stats. Nuevos códigos de error gone, payload_too_large y unsupported_media_type. 405 enumera los métodos permitidos. |
1.1.0 | 2026-09-17 | Las fichas de aeródromo incluyen taxiways. Aditivo: no cambió ninguna ruta ni ningún campo existente. |
1.0.0 | 2026-09-17 | Primera versión: la clave personal y rutas de sólo lectura para aeródromos, aeronaves, meteorología, notas, planes de vuelo, el libro de vuelo y sus totales, y el perfil del piloto. |