API TukeyStat
TukeyStat utiliza una capa interna para consultar fuentes oficiales, normalizar respuestas y entregar datos consistentes a visualizaciones, tablas, descargas y futuras integraciones profesionales.
Endpoint principal
/api/data-sources/indicator
Fuentes registradas
12
Conectores técnicos
20
GET /api/data-sources/indicator
source
Sí
Clave de la fuente registrada. Ejemplo: worldbank, cepalstat, wto.
indicator
Sí
Código del indicador según la fuente original.
countries
No
Lista de códigos ISO3 separados por punto y coma. Ejemplo: PER;CHL.
startYear
No
Año inicial de la consulta.
endYear
No
Año final de la consulta.
frequency
No
Frecuencia esperada. Valores: annual, quarterly, monthly, daily, irregular, unknown.
Ejemplos
HTTP esperado: 200
Consulta población total para Perú y Chile usando la fuente activa Banco Mundial.
/api/data-sources/indicator?source=worldbank&indicator=SP.POP.TOTL&countries=PER;CHL&startYear=2020&endYear=2026&frequency=annual
HTTP esperado: 200, 502 o advertencias según validación
Ejemplo de consulta a CEPALSTAT. La fuente está preparada, pero algunos indicadores requieren validar dimensiones y miembros.
/api/data-sources/indicator?source=cepalstat&indicator=178&countries=ECU;COL&startYear=2020&endYear=2026&frequency=annual
HTTP esperado: 501
Ejemplo de respuesta para una fuente registrada en TukeyStat, pero todavía no implementada como adaptador normalizado.
/api/data-sources/indicator?source=wto&indicator=TEST
HTTP esperado: 400
Ejemplo de solicitud inválida cuando no se envía el parámetro source.
/api/data-sources/indicator?indicator=SP.POP.TOTL
Fuentes
No todas las fuentes registradas están operativas. Algunas están activas, otras preparadas y otras permanecen como candidatas hasta completar validación técnica, metodológica y legal.
World Bank
Estado público: API activa
Conector
implemented
Protocolo
REST
API key
No requerida
Ruta
/api/worldbank/indicator
Comisión Económica para América Latina y el Caribe
Estado público: API activa
Conector
implemented
Protocolo
REST
API key
No requerida
Ruta
/api/data-sources/cepalstat/indicator
Organización Mundial del Comercio
Estado público: Pendiente de evaluación
Conector
candidate
Protocolo
REST
API key
Requerida
Ruta
/api/wto/timeseries
United Nations Statistics Division
Estado público: Pendiente de evaluación
Conector
research-required
Protocolo
SDMX
API key
No requerida
Ruta
/api/undata/series
International Monetary Fund
Estado público: Pendiente de evaluación
Conector
candidate
Protocolo
SDMX
API key
No requerida
Ruta
/api/imf/indicator
Organisation for Economic Co-operation and Development
Estado público: Pendiente de evaluación
Conector
candidate
Protocolo
SDMX
API key
No requerida
Ruta
/api/oecd/indicator
European Commission
Estado público: Pendiente de evaluación
Conector
candidate
Protocolo
SDMX
API key
No requerida
Ruta
/api/eurostat/indicator
International Labour Organization
Estado público: Pendiente de evaluación
Conector
candidate
Protocolo
SDMX
API key
No requerida
Ruta
/api/ilostat/indicator
Food and Agriculture Organization
Estado público: Pendiente de evaluación
Conector
candidate
Protocolo
REST
API key
No requerida
Ruta
/api/faostat/indicator
World Health Organization
Estado público: Pendiente de evaluación
Conector
candidate
Protocolo
OData
API key
No requerida
Ruta
/api/who/indicator
United Nations Statistics Division
Estado público: Pendiente de evaluación
Conector
candidate
Protocolo
REST
API key
No requerida
Ruta
/api/unsd-sdg/indicator
OpenAQ
Estado público: Pendiente de evaluación
Conector
candidate
Protocolo
REST
API key
Requerida
Ruta
/api/openaq/measurements
Respuestas HTTP
200
La ruta procesó la solicitud y devolvió una respuesta normalizada. Puede incluir warnings si la fuente respondió parcialmente.
400
Falta source o indicator, la fuente no existe, o startYear/endYear no son valores válidos.
501
La fuente está registrada en TukeyStat, pero todavía no tiene adaptador operativo.
502
El adaptador existe, pero la fuente externa no respondió correctamente o la respuesta no pudo normalizarse.
Constructor de consulta
Ruta generada
/api/data-sources/indicator?source=worldbank&indicator=SP.POP.TOTL&countries=PER%3BCHL&startYear=2020&endYear=2026&frequency=annual
Fuente seleccionada: Banco Mundial. La respuesta puede variar según disponibilidad del adaptador, código del indicador y parámetros enviados.