Docs
API pública
JSON sobre HTTPS, sin autenticación para lectura. Fechas en ISO-8601 UTC. Cache-Control: public, max-age=60 en los GET. CORS habilitado para bonamx.org, www.bonamx.org y entre-tiempos.com; otras aplicaciones pueden consumirla del lado del servidor.
Endpoints
| Método | Ruta | Descripción | Caché |
|---|---|---|---|
GET | /api/estado | Contrato v1 que consume BONA. Semáforo general, última corrida, contadores y siguiente corrida programada. | 60 s |
GET | /api/corridas?limit=20 | Historial de corridas (máx. 100), con errores legibles por fuente, proveedor de IA y duración. | 60 s |
GET | /api/items?desde=&tema=&min=&limit= | Señales detectadas. Filtros: fecha ISO desde, tema (bosques|agua|aire|biodiversidad|incendios|politica|datos|general), relevancia mínima. | 60 s |
GET | /api/fuentes | Catálogo de fuentes con tipo, licencia, frecuencia, última lectura y último error. | 60 s |
GET | /api/boletin/ultimo | Último borrador de boletín en Markdown, con la corrida que lo produjo. | 60 s |
POST | /api/correr | Disparo manual protegido con Bearer token. Devuelve el resumen de la corrida (200) o 202 si se pide ?async=1. ?modo=diaria limita a fuentes diarias. | no |
GET | /api/diagnostico?url= | Protegido. Prueba Workers AI y descarga una URL desde el Worker (para depurar fuentes). | no |
Contrato GET /api/estado (versión 1)
Es el acuerdo con BONA. Cambios futuros subirán version y mantendrán compatibilidad un ciclo.
curl -s https://sinapmex.com/api/estado | jq{
"version": "1",
"estado": "ok", // ok | parcial | error | sin-datos
"ultimaCorrida": {
"id": "2026-11-16T02:40:03.608Z",
"inicio": "2026-11-16T02:40:03.608Z",
"fin": "2026-11-16T02:40:09.868Z",
"estado": "ok" // ok | parcial | error
},
"fuentesRevisadas": 11,
"fuentesConError": 0,
"itemsNuevos": 102,
"alertasNuevas": 4, // ítems de la corrida con relevancia >= 70
"siguienteCorrida": "2026-11-16T12:00:00.000Z", // null si el cron está apagado
"generadoEn": "2026-11-16T02:40:10.623Z"
}- Si nunca ha corrido:
estado: "sin-datos",ultimaCorrida: null, contadores en 0. siguienteCorridase calcula desde los crons0 12 * * 1(semanal) y0 13 * * *(diaria), UTC.- El consumidor debe mostrar «dato desactualizado» si
generadoEntiene más de 8 días, y un estado neutral si el fetch falla.
Ejemplos
# Últimas 5 corridas
curl -s "https://sinapmex.com/api/corridas?limit=5" | jq '.corridas[] | {inicio, estado, itemsNuevos, errores}'
# Señales de bosques con relevancia >= 60 desde el 1 de noviembre
curl -s "https://sinapmex.com/api/items?tema=bosques&min=60&desde=2026-11-01" | jq '.items[] | {titulo, relevancia, url}'
# Fuentes con error en la última lectura
curl -s https://sinapmex.com/api/fuentes | jq '.fuentes[] | select(.ultimoEstado == "error") | {nombre, ultimoError}'
# Último borrador de boletín (Markdown)
curl -s https://sinapmex.com/api/boletin/ultimo | jq -r '.boletin.markdown'
# Disparo manual (requiere SINAPMEX_TOKEN)
curl -s -X POST -H "Authorization: Bearer $SINAPMEX_TOKEN" https://sinapmex.com/api/correr | jq
# Disparo asíncrono (202 inmediato) solo de fuentes diarias
curl -s -X POST -H "Authorization: Bearer $SINAPMEX_TOKEN" "https://sinapmex.com/api/correr?async=1&modo=diaria"Errores
Siempre JSON: { "error": "mensaje legible", "status": 4xx|5xx }. 401 token inválido · 405 método no permitido · 409 ya hay una corrida en curso · 503 token no configurado en el servidor.
Uso y licencia de los datos
Los metadatos que produce Sinapmex (relevancia, tema, resumen, registro de corridas) se publican bajo CC BY 4.0. Los títulos, enlaces y extractos pertenecen a cada fuente y se redistribuyen solo con fines informativos y de enlace; consulta la licencia de cada una en Fuentes. Sin límites de tasa formales por ahora: sé razonable (≤ 1 petición/segundo) y cachea.