ACCESO PÚBLICO A DATOS / SIN AUTENTICACIÓN

Documentación de API y RSS

Use la API JSON de solo lectura para datos estructurados o suscríbase al canal RSS para recibir los artículos más recientes del informe diario. No se requiere clave de API, cuenta, cookie ni sesión de base de datos.

API versión 1 Inglés de EE. UU. y español de EE. UU. Solo lectura

JSON API

Flujo de inteligencia

El flujo local normalizado que utiliza la Mesa de inteligencia. Admite revalidación ETag y una caché pública de cinco minutos.

https://internationalintelligence.org/es-US/api/feed/ Abrir flujo JSON

RSS 2.0

Canal de noticias recientes

Hasta 50 entradas recientes de artículos del informe diario con títulos, resúmenes, fechas, categorías y URL localizadas.

https://internationalintelligence.org/es-US/rss/ Abrir canal RSS

STATUS JSON

Estado de publicación

Una instantánea operativa redactada de las actualizaciones de fuentes y la publicación del informe diario. Nunca expone credenciales ni respuestas del proveedor.

https://internationalintelligence.org/es-US/api/status/ Abrir JSON de estado

REFERENCIA DE ENDPOINTS

Endpoints públicos

Método y ruta	Formato	Propósito y caché
`GET /es-US/api/feed/`	`application/json`	Elementos de inteligencia normalizados. Caché pública: 300 segundos. Envíe If-None-Match con el ETag anterior para recibir HTTP 304 cuando no haya cambios.
`GET /es-US/api/status/`	`application/json`	Estado redactado de fuentes e informe diario. Cache-Control es no-store porque el estado puede cambiar entre solicitudes.
`GET /es-US/rss/`	`application/rss+xml`	Canal RSS 2.0 localizado que contiene hasta 50 páginas recientes de historias del informe diario. Caché pública: 900 segundos con compatibilidad ETag.
`GET /rss.xml`	`application/rss+xml`	Alias de canal de máquina x-default en inglés para lectores que esperan una URL RSS en la raíz.
`GET /openapi.json`	`application/json`	Descripción OpenAPI 3.1 de las interfaces públicas de solo lectura y sus esquemas de respuesta.

INICIO RÁPIDO

Ejemplos listos para copiar

curl

curl --fail --silent --show-error \
  -H 'Accept: application/json' \
  'https://internationalintelligence.org/es-US/api/feed/'

Solicitud condicional con ETag

curl --fail --silent --show-error \
  -H 'If-None-Match: "YOUR_PREVIOUS_ETAG"' \
  'https://internationalintelligence.org/es-US/api/feed/'

JavaScript sencillo

const response = await fetch('/es-US/api/feed/', {
  headers: { Accept: 'application/json' }
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const feed = await response.json();
console.log(feed.items);

URL de suscripción RSS

https://internationalintelligence.org/es-US/rss/

CONTRATO DE DATOS

Esquema del flujo de un vistazo

El flujo JSON es un artefacto de publicación local. Las cargas específicas de cada fuente se normalizan en un contenedor superior estable y registros conscientes de la fuente.

schema_versionVersión numérica del contrato.

generated_atHora ISO 8601 de generación de la caché.

source_modeNormalmente seed o caché actualizada.

items[]Registros normalizados conscientes de la fuente.

evidence_tierPosición numérica en la Escala de Evidencia.

confidenceEtiqueta visible de confianza editorial.

Respuesta de ejemplo

{
    "schema_version": 1,
    "generated_at": "2026-07-24T09:15:00-05:00",
    "source_mode": "seed",
    "item_count": 10,
    "items": [
        {
            "id": "794212aa32e5bd2edf638d4c",
            "title": "Arquitectura de inteligencia pública sin exponer al lector",
            "summary": "Un informe fundacional explica la adquisición en servidor, el esquema común de evidencia, los conectores oficiales, el flujo de compras y el despliegue en alojamiento PHP.",
            "url": "/es-US/research/architecting-public-intelligence/",
            "published_at": "2026-07-24T09:00:00-05:00",
            "source": "International Intelligence Research Desk",
            "topics": [
                "public-records",
                "privacy",
                "procurement",
                "surveillance"
            ],
            "evidence_tier": 6,
            "confidence": "Corroborated"
        }
    ]
}

USO RESPONSABLE

Caché, procedencia y estabilidad

No se requiere autenticación para los endpoints de solo lectura documentados.
Respete los encabezados Cache-Control y ETag en lugar de consultar continuamente.
Conserve los nombres de las fuentes, niveles de evidencia, etiquetas de confianza, fechas de publicación y enlaces a las fuentes originales.
La API contiene material actual y provisional. No lo reetiquete silenciosamente como hecho histórico establecido.
La interfaz pública se versiona independientemente de la versión del sitio. Los cambios incompatibles requieren una nueva versión del contrato API.