{"openapi":"3.0.3","info":{"title":"API de Consumo y Monitoreo PbR-SED — H. Ayuntamiento de Boca del Río","version":"1.0.0","description":"API RESTful oficial para el consumo en tiempo real de metas, avances mensuales, desglose de beneficiarios, indicadores MIR y analítica institucional del Municipio de Boca del Río, Veracruz."},"servers":[{"url":"/api/v1","description":"Servidor PbR API v1"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API Key institucional para consumo directo (ej. boca_api_key_live_2026_pbr_sed)"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"paths":{"/avances":{"get":{"summary":"Obtener avances mensuales capturados","parameters":[{"name":"mes","in":"query","schema":{"type":"integer","default":7}},{"name":"anio","in":"query","schema":{"type":"integer","default":2026}},{"name":"id_dependencia","in":"query","schema":{"type":"integer"}},{"name":"semaforo","in":"query","schema":{"type":"string","enum":["VERDE","AMARILLO","ROJO"]}}]}},"/avances/{id}":{"get":{"summary":"Detalle de un avance con beneficiarios y evidencias"}},"/avances/indicador/{id}/historico":{"get":{"summary":"Serie temporal de 12 meses para un indicador"}},"/avances/alertas-riesgo":{"get":{"summary":"Lista de indicadores en semáforo rojo o con rezago"}},"/mir/actividades":{"get":{"summary":"Catálogo de actividades MIR con sus 12 metas calendarizadas"}},"/mir/actividades/{id}":{"get":{"summary":"Ficha técnica completa de un indicador"}},"/mir/niveles":{"get":{"summary":"Métricas de indicadores agrupados por nivel MIR"}},"/mir/frecuencias":{"get":{"summary":"Frecuencias de medición de indicadores"}},"/beneficiarios":{"get":{"summary":"Desglose demográfico de beneficiarios por actividad"}},"/beneficiarios/resumen-demografico":{"get":{"summary":"Total municipal consolidado de población atendida"}},"/beneficiarios/por-dependencia":{"get":{"summary":"Población atendida por dependencia"}},"/analitica/resumen-ejecutivo":{"get":{"summary":"KPIs directivos consolidados del municipio"}},"/analitica/ranking-dependencias":{"get":{"summary":"Ranking institucional por cumplimiento"}},"/analitica/por-eje-pmd":{"get":{"summary":"Desempeño agrupado por Ejes del Plan Municipal"}},"/analitica/por-ods":{"get":{"summary":"Alineación a los 17 ODS de la Agenda 2030"}},"/analitica/trimestral":{"get":{"summary":"Rendición de cuentas trimestral"}},"/catalogos/dependencias":{"get":{"summary":"Directorio oficial de dependencias"}},"/catalogos/programas":{"get":{"summary":"Catálogo de programas presupuestarios"}},"/catalogos/ods":{"get":{"summary":"Catálogo de Objetivos de Desarrollo Sostenible"}},"/catalogos/periodos":{"get":{"summary":"Calendario y estatus de los 12 meses de evaluación"}},"/dictamenes/estatus-dependencias":{"get":{"summary":"Estado de dictaminación por área"}},"/auditoria/trazabilidad":{"get":{"summary":"Bitácora forense de auditoría"}},"/export/json":{"get":{"summary":"Volcado completo en formato JSON"}},"/export/csv":{"get":{"summary":"Exportación masiva en CSV","parameters":[{"name":"tipo","in":"query","schema":{"type":"string","enum":["avances","mir","beneficiarios","ranking"]}}]}}}}