# EKIA Data Service — API de Datos Oficiales Peruanos

> API de solo lectura de Eurekia sobre datos oficiales del Perú, con un modelo
> de auditabilidad completo: cada valor es una observación inmutable respaldada
> por los bytes exactos que la fuente oficial respondió (metadatos en
> `/v1/evidence/{id}`, bytes en `/v1/evidence/{id}/descarga`, verificables por SHA-256), el dataset está versionado por revisiones
> (`as_of_revision` reproduce cualquier estado pasado byte a byte) y las
> correcciones se registran por supersesión, nunca reescribiendo el pasado.
> Dominios: tipo de cambio — series `publicado` (USD, SUNAT) y `cierre`
> (USD, SBS vía BCRP), con cotejos cruzados entre ambas y cobertura desde el
> 2026-08-21 —, consulta RUC (padrón reducido diario de SUNAT, cobertura
> desde el 2026-09-03) y calendario de feriados (público).
> URL base de la API: https://api.eurekia.pe (token Bearer). SERVICIO EN
> DESARROLLO, SIN ACCESO PÚBLICO POR AHORA: esta documentación se publica
> como material técnico, sin credenciales ni vía de acceso. Sin relleno: una fecha
> sin dato responde el hueco con su razón, jamás otra fecha.

Cada página existe en HTML y en espejo Markdown (misma URL, extensión `.md`).

## La plataforma

- [Inicio](https://docs.eurekia.pe/index.md): qué hace distinta a esta API y el índice de la documentación
- [Empezar](https://docs.eurekia.pe/empezar.md): estado del servicio (en desarrollo, sin acceso a terceros), autenticación, primer request en cada dominio con respuesta real, sobre vs campos del dominio, /v1/usage
- [Verifique la evidencia en 60 segundos](https://docs.eurekia.pe/verificar-evidencia.md): cuatro pasos abstractos (dato → observación → metadatos de la evidencia → descarga y sha256) y su forma en cada dominio, ejecutados reales
- [El modelo de evidencia](https://docs.eurekia.pe/modelo-de-evidencia.md): observaciones inmutables, revisiones, marcas y transiciones, controles de integridad (cotejo, confiabilidad), sin relleno, evidencia unificada, retención indefinida, tabla completa de estados, qué guardar
- [Errores y límites](https://docs.eurekia.pe/errores-y-limites.md): la tabla completa de códigos de error (por dominio), límites de uso, cuota de descarga, paginación a revisión fija, caché, alertas y salud
- [Qué no hacemos](https://docs.eurekia.pe/que-no-hacemos.md): datos de personas solo con convenio RENIEC (hoy no lo tenemos), sin scraping de fuentes protegidas, sin cifras de desempeño sin método de medición
- [Registro de cambios](https://docs.eurekia.pe/registro-de-cambios.md): todo cambio del contrato de la API, fechado; nombres deprecados que siguen viajando
- [Referencia de la API](https://docs.eurekia.pe/api.md): los endpoints de la v1 por servicio — versión interactiva en https://docs.eurekia.pe/api.html

## Servicios

- [Tipo de cambio](https://docs.eurekia.pe/tipo-de-cambio.md): plantilla de 8 H2 — qué es y qué no, cobertura (desde 2026-08-21), frescura por serie, consulta histórica (404 NO_OBSERVATIONS), integridad (cotejo), evidencia pequeña, restricciones, qué guardar; guía "Publicado vs cierre"
- [Consulta RUC](https://docs.eurekia.pe/consulta-ruc.md): plantilla de 8 H2 — el padrón reducido diario de SUNAT (cuatro estados de fila), cobertura con razón (desde 2026-09-03), frescura, consulta histórica (as_of_fecha → 200 solo metadatos; historia paginada), integridad (confiabilidad verificada como estado normal; sin cotejo), evidencia grande (ZIP por sha256, redirect firmado), restricciones (E1: personas naturales y by-dni cerrados, métrica de cobertura del prefijo 10, variante mínima como pregunta del dictamen), qué guardar
- [Calendario](https://docs.eurekia.pe/calendario.md): plantilla de 8 H2 — feriados nacionales 2026 y 2027 con su norma legal (DL 713, Ley 31381, Ley 31788; Semana Santa 2027 del calendario litúrgico identificado), público sin token, parte del servicio en desarrollo; contrato de sincronización por año (`contract_version`, `coverage` declarada complete|unsupported, `declarations` con revisión, `tombstones` con `retira_revision`; las cuatro revisiones explicadas); qué no entra (días no laborables por decreto supremo, regionales); sin frescura ni evidencia, y por qué; consulta histórica como rastro de actos append-only; cambios fechados en el registro de cambios

## Esquema

- [OpenAPI 3.1 (JSON)](https://docs.eurekia.pe/openapi.json): esquema crudo curado, en URL estable; es espejo verificado del código del servicio