Saltar al contenido
Sinapmex

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étodoRutaDescripciónCaché
GET/api/estadoContrato v1 que consume BONA. Semáforo general, última corrida, contadores y siguiente corrida programada.60 s
GET/api/corridas?limit=20Historial 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/fuentesCatá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/correrDisparo 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"
}

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.