# Aerocapacitación para Desarrolladores y Agentes de IA

> Recursos abiertos de Aerocapacitación (Escuela de Aviación ANTA): llms.txt, agents.md, API pública de cursos y sedes, OpenAPI y contenido en Markdown. desarrolladores

- URL canónica: https://aerocapacitacion.com/desarrolladores/
- Sitio: Aerocapacitación — Escuela de Aviación Aero Edu MX (ANTA)
- Actualizado: 2026-09-06
- Idioma: es-MX

---

# 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](https://www.gob.mx/afac/acciones-y-programas/instituciones-y-adiestramiento).
- 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](https://www.rfc-editor.org/info/rfc9727), 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](https://aerocapacitacion.com/llms.txt) | Índice curado del sitio con sección «cuándo usar», en el formato de [llmstxt.org](https://llmstxt.org). |
| llms-full.txt | [/llms-full.txt](https://aerocapacitacion.com/llms-full.txt) | El texto completo de páginas y artículos en Markdown, en un solo archivo. |
| agents.md | [/agents.md](https://aerocapacitacion.com/agents.md) | Instrucciones para agentes: cuándo recurrir a nosotros, cómo consumirnos y reglas al citarnos. |
| OpenAPI | [/openapi.json](https://aerocapacitacion.com/openapi.json) | Especificación OpenAPI 3.1 de la API pública. `security: []`: acceso anónimo. |
| Catálogo de APIs | [/.well-known/api-catalog](https://aerocapacitacion.com/.well-known/api-catalog) | Descubrimiento automático conforme a RFC 9727 (Linkset JSON). |
| Sitemap | [/sitemap_index.xml](https://aerocapacitacion.com/sitemap_index.xml) | Índice de mapas del sitio (páginas, entradas, categorías, local). |
| robots.txt | [/robots.txt](https://aerocapacitacion.com/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](https://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](https://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-Agent` descriptivo 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](mailto:aerocancunmx@gmail.com). Para asesoría académica dirige a las personas a [/contacto/](https://aerocapacitacion.com/contacto/), al teléfono [981 229 1830](tel:+529812291830) o a [WhatsApp](https://wa.me/529812291830).

---

## Contacto

- Teléfono: +52 981 229 1830
- WhatsApp: https://wa.me/529812291830
- Correo: aerocancunmx@gmail.com
- Formulario de contacto: https://aerocapacitacion.com/contacto/
- Índice para agentes: https://aerocapacitacion.com/llms.txt
