{
    "openapi": "3.1.0",
    "info": {
        "title": "Aerocapacitación — API pública de cursos y sedes",
        "version": "1.0.0",
        "description": "API de solo lectura de Aerocapacitación — Escuela de Aviación Aero Edu MX (ANTA). Expone el catálogo de cursos de aviación y las sedes en México. No requiere autenticación, clave de API ni registro: la primera petición ya funciona. Como ningún endpoint modifica datos, este mismo entorno sirve como sandbox.",
        "contact": {
            "name": "Aerocapacitación",
            "url": "https://aerocapacitacion.com/desarrolladores/",
            "email": "aerocancunmx@gmail.com"
        }
    },
    "servers": [
        {
            "url": "https://aerocapacitacion.com/wp-json/aerocapacitacion/v1"
        }
    ],
    "security": [],
    "paths": {
        "/ping": {
            "get": {
                "operationId": "ping",
                "summary": "Estado del servicio (sin autenticación)",
                "description": "Comprobación de disponibilidad. Útil para verificar el servicio antes de consumir el resto de la API.",
                "responses": {
                    "200": {
                        "description": "Servicio disponible",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "estado": {
                                            "type": "string",
                                            "example": "ok"
                                        },
                                        "hora_utc": {
                                            "type": "string",
                                            "format": "date-time"
                                        },
                                        "version": {
                                            "type": "string"
                                        },
                                        "autenticacion": {
                                            "type": "string",
                                            "example": "no requerida"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/cursos": {
            "get": {
                "operationId": "listCursos",
                "summary": "Lista los cursos de aviación disponibles",
                "responses": {
                    "200": {
                        "description": "Listado de cursos",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/Recurso"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/sedes": {
            "get": {
                "operationId": "listSedes",
                "summary": "Lista las sedes (campus) en México",
                "responses": {
                    "200": {
                        "description": "Listado de sedes",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/Recurso"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "Recurso": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "nombre": {
                        "type": "string"
                    },
                    "slug": {
                        "type": "string"
                    },
                    "url": {
                        "type": "string",
                        "format": "uri"
                    },
                    "url_markdown": {
                        "type": "string",
                        "format": "uri"
                    },
                    "resumen": {
                        "type": "string"
                    },
                    "actualizado": {
                        "type": "string",
                        "format": "date"
                    }
                }
            }
        }
    }
}