REST sobre HTTPS
Una API REST con recursos predecibles, respuestas en JSON y siempre cifrada en tránsito. Sin protocolos exóticos: si has usado cualquier API moderna, esta te resultará familiar.
La API de AeroCopi,
en preparación
Todavía no hay endpoints que llamar. Aquí está el enfoque que tendrá la API pública cuando llegue, contado en claro: sin inventar rutas como si ya existieran.
Esto es un plan, no una referencia cerrada
Lo que lees aquí es el enfoque previsto de la API. Los nombres exactos de recursos, campos, parámetros y eventos pueden cambiar antes de la publicación. Cuando la API entre en producción, esta misma página pasará a ser la referencia oficial con ejemplos reales y verificables.
[ ENFOQUE PREVISTO ]
Cuatro pilares, cero humo
La API que estamos diseñando se apoya en cuatro ideas simples. Ninguna está disponible aún; las describimos para que sepas hacia dónde va y puedas decir la tuya antes de que se congele.
Autenticación por token
Tokens de acceso por organización, revocables desde tu cuenta. Los generas tú, los envías en la cabecera de cada petición y los apagas cuando quieras. Nada de contraseñas en el código.
Exportación de datos
Lectura de tu flota, tus pilotos y tu logbook de vuelos para llevarte tus datos a tu BI, tu ERP o donde necesites. Tus datos son tuyos; la API es la puerta para sacarlos.
Webhooks de avisos
Notificaciones automáticas cuando un seguro RC, una licencia o una aptitud médica está por vencer. Tu sistema se entera en el momento, sin que nadie tenga que mirar un panel.
[ EJEMPLO ILUSTRATIVO ]
Cómo se verá, más o menos
Para que te hagas una idea, así de simple debería ser pedir tu flota: una petición autenticada con tu token y una respuesta en JSON con tus aeronaves. El bloque de abajo es ilustrativo y previsto: la ruta, los campos y el formato exactos se confirmarán al publicar la API. No lo copies a producción todavía, porque todavía no existe.
La filosofía es la misma que en el resto de AeroCopi: lo construye un piloto FPV harto del papeleo, no un comité. Si algo se puede hacer obvio, se hace obvio. Para entender qué datos hay detrás de cada recurso, mira la gestión de flota y el logbook digital.
Ejemplo · previstono disponible aún
# Petición (enfoque previsto)
GET /v1/drones HTTP/1.1
Host: api.aerocopi.com
Authorization: Bearer TU_TOKEN
Accept: application/json
# Respuesta (ejemplo ilustrativo)
{
"data": [
{
"id": "drn_...",
"modelo": "...",
"categoria": "especifica",
"seguro_rc": {
"vencimiento": "AAAA-MM-DD",
"estado": "vigente"
}
}
]
}Nota: el dominio, las rutas y los campos del ejemplo son orientativos y pueden cambiar. No hay endpoints en producción; este bloque ilustra el estilo, no un contrato vigente.
[ EN POCAS PALABRAS ]
Qué hay y qué no, sin rodeos
Lo honesto primero: hoy no hay API pública. No hay clave que generar ni petición que lanzar. Lo que sí hay es un plan claro y la voluntad de definirlo con quien va a usarlo de verdad.
Mientras tanto, los datos que la API expondrá ya existen y se gestionan dentro de AeroCopi. Si quieres ver el estado del servicio o el resto de la documentación, tienes el estado del servicio y el centro de documentación. Para ver cuándo entra la API y qué viene antes, pásate por el roadmap.
[ Estado de la API ]
- Disponibilidad
- En preparación
- Llega con
- Lanzamiento público (mes 6)
- Fase del producto
- Beta cerrada
- Protocolo previsto
- REST sobre HTTPS, JSON
- Autenticación prevista
- Token de acceso por organización, revocable
- Lectura prevista
- Flota, pilotos y logbook de vuelos
- Eventos previstos
- Webhooks de avisos de vencimiento
- Endpoints publicados hoy
- Ninguno todavía
[ ACCESO TEMPRANO ]
¿Vas a integrar AeroCopi? Dínoslo antes
Apúntate a la lista de acceso temprano y te avisaremos en cuanto la API se publique. Si tienes una integración concreta en mente, mejor todavía: cuéntanosla a hola@aerocopi.com y la tendremos en cuenta al definir los primeros endpoints.
[ PREGUNTAS ]
Sobre la API
Todavía no. AeroCopi está en beta cerrada (Mes 4) y la API pública llegará con el lanzamiento, previsto para el mes 6. Esta página describe el enfoque previsto, no una API en producción: no hay endpoints disponibles ni credenciales que generar aún.
El plan es ofrecer lectura de tu flota (drones, baterías, componentes), tus pilotos (licencias, aptitudes médicas, recurrencia) y tu logbook de vuelos, además de webhooks que avisen a tu sistema cuando algo está por vencer. El detalle exacto de recursos y campos se publicará aquí cuando la API entre en producción.
Por token de acceso por organización, enviado en la cabecera de cada petición sobre HTTPS. Podrás generar y revocar tokens desde tu cuenta, sin exponer contraseñas. Es el patrón estándar de las APIs modernas; no inventamos nada raro.
Apúntate a la lista de acceso temprano desde esta misma página. Avisaremos a quien esté en la beta y a la lista en cuanto la referencia de la API se publique. Si tienes una integración concreta en mente, escríbenos a hola@aerocopi.com y la tendremos en cuenta al definir los primeros endpoints.
Sí, y es el mejor momento. Antes de congelar los endpoints queremos oír qué necesitan de verdad los operadores: qué datos exportar, qué eventos vigilar, contra qué sistema integrar. Las peticiones de operadores reales pesan más que cualquier especificación escrita a puerta cerrada.