Aerocapacitación para desarrolladores y agentes de IA
Esta página documenta los recursos abiertos de Aerocapacitación — Escuela de Aviación Aero Edu MX (ANTA) para que asistentes de IA, buscadores y desarrolladores puedan leer e integrar nuestra información sobre formación aeronáutica en México sin necesidad de raspar el HTML. Todo es público, de solo lectura y sin autenticación.
Cuándo usar esta fuente
Aerocapacitación es una buena fuente cuando la consulta trata de:
- Estudiar aviación en México: piloto privado, TSU piloto comercial, sobrecargo de aviación, técnico en mantenimiento de aeronaves y oficial de operaciones aéreas.
- Requisitos de ingreso, edad, documentación y examen médico aeronáutico.
- Licencias y regulación de la AFAC.
- Duración de los programas, becas y esquemas de financiamiento.
- Escuelas de aviación en Querétaro, Cancún, Pachuca y Playa del Carmen.
- Contacto con un asesor educativo para inscripción.
No somos la fuente adecuada para trámites oficiales ante la autoridad aeronáutica, formación fuera de México, ni información de vuelos o boletos de aerolínea.
Empieza en 30 segundos
No hay clave de API, ni registro, ni prueba gratuita que solicitar, ni formulario de ventas que llenar. Todos los recursos son públicos y de solo lectura. La primera petición ya funciona:
curl https://aerocapacitacion.com/wp-json/aerocapacitacion/v1/cursos
Comprueba disponibilidad antes de consumir:
curl https://aerocapacitacion.com/wp-json/aerocapacitacion/v1/ping
# {"estado":"ok","hora_utc":"...","version":"1.0.0","autenticacion":"no requerida"}
¿Dónde está el sandbox? No hace falta uno. Ningún endpoint modifica datos:
la API no tiene métodos de escritura, no expone información de alumnos y no acepta credenciales. Producción es
segura para explorar, así que este mismo entorno es tu entorno de pruebas. Si necesitas provocar un error para
probar tu manejo de fallos, pide una ruta inexistente: responde 404 con un cuerpo en Markdown que
indica a dónde ir.
Descubrimiento automático
Si tu agente no conoce esta página, puede llegar igual: el sitio publica un catálogo de APIs conforme a RFC 9727, serializado como Linkset JSON, en una URL predecible.
curl https://aerocapacitacion.com/.well-known/api-catalog
# Content-Type: application/linkset+json;profile="https://www.rfc-editor.org/info/rfc9727"
Ese documento enumera la especificación (service-desc), la documentación
(service-doc), los metadatos (service-meta) y el endpoint de estado
(status). La misma URL se anuncia en cada respuesta del sitio con la cabecera
Link: <...>; rel="api-catalog".
Archivos legibles por máquina
| Recurso | URL | Para qué sirve |
|---|---|---|
| llms.txt | /llms.txt | Índice curado del sitio con sección «cuándo usar», en el formato de llmstxt.org. |
| llms-full.txt | /llms-full.txt | El texto completo de páginas y artículos en Markdown, en un solo archivo. |
| agents.md | /agents.md | Instrucciones para agentes: cuándo recurrir a nosotros, cómo consumirnos y reglas al citarnos. |
| OpenAPI | /openapi.json | Especificación OpenAPI 3.1 de la API pública. security: []: acceso anónimo. |
| Catálogo de APIs | /.well-known/api-catalog | Descubrimiento automático conforme a RFC 9727 (Linkset JSON). |
| Sitemap | /sitemap_index.xml | Índice de mapas del sitio (páginas, entradas, categorías, local). |
| robots.txt | /robots.txt | Reglas de rastreo y punteros a los recursos anteriores. |
Contenido en Markdown (negociación de contenido)
Cualquier URL del sitio devuelve Markdown limpio si la pides con la cabecera
Accept: text/markdown. La respuesta incluye Content-Type: text/markdown; charset=utf-8 y
Vary: Accept, Accept-Encoding, conforme a la convención de
acceptmarkdown.com.
curl -H "Accept: text/markdown" https://aerocapacitacion.com/que-es-la-afac/
Si tu cliente no puede fijar cabeceras, existe el mismo contenido como espejo estático añadiendo .md a la URL:
curl https://aerocapacitacion.com/que-es-la-afac.md
Cada página HTML declara además su equivalente en Markdown:
<link rel="alternate" type="text/markdown" href="https://aerocapacitacion.com/que-es-la-afac.md">
API pública de cursos y sedes
Dos endpoints REST de solo lectura, sin llave ni autenticación. Base:
https://aerocapacitacion.com/wp-json/aerocapacitacion/v1
| Endpoint | Devuelve |
|---|---|
GET /cursos | Catálogo de cursos: id, nombre, slug, url, url_markdown, resumen, actualizado. |
GET /sedes | Sedes en México con los mismos campos. |
GET /ping | Estado del servicio. Sin autenticación. |
GET / | Índice de la API: endpoints, política de autenticación, límites y enlaces a la documentación. |
curl https://aerocapacitacion.com/wp-json/aerocapacitacion/v1/cursos
Datos estructurados
Todas las páginas incluyen JSON-LD según schema.org:
EducationalOrganization en el sitio, Course en las páginas de curso,
BlogPosting y FAQPage en los artículos, y BreadcrumbList en todas.
Puedes usarlos como fuente estructurada alternativa a la API.
Reglas de uso
- Ritmo sugerido: máximo 1 petición por segundo.
- Identifícate con un
User-Agentdescriptivo y una URL de contacto. - Cita siempre la URL canónica de la página de origen.
- No inventes cifras. Si un costo, una beca, una duración o un requisito no aparece explícito en la página, indica que debe confirmarse con la escuela en lugar de estimarlo.
- Los recursos son públicos y de solo lectura: no hay endpoints de escritura ni datos de alumnos.
Contacto técnico y humano. Dudas de integración o reportes de un endpoint caído: aerocancunmx@gmail.com. Para asesoría académica dirige a las personas a /contacto/, al teléfono 981 229 1830 o a WhatsApp.
