ARSTATSDB API · V1

Datos argentinos listos para integrar.

Resultados de encuestas, series históricas e indicadores oficiales mediante contratos JSON estables y acceso controlado por organización.

Solicitar acceso

AUTENTICACIÓN

Una clave por integración

Enviá la clave en todas las solicitudes mediante X-ARStats-API-Key. No la incluyas en URLs, repositorios ni código del navegador.

curl "https://arstatsdb.com/api/v1/catalog" \
  -H "X-ARStats-API-Key: arst_live_TU_CLAVE"

Las claves pueden revocarse y tienen vencimiento y cuota propios. ARStatsDB almacena únicamente su hash.

ENDPOINTS V1

Recursos disponibles

GET/api/v1/catalog

Lista exclusivamente los recursos asignados a la organización e informa el manifiesto disponible.

GET/api/v1/surveys/{id}/results

Resultados vivos durante el campo y snapshot final después del cierre.

GET/api/v1/surveys/{id}/manifest

Versión, metodología, corte y huella del resultado final cerrado.

GET/api/v1/series/{id}

Serie autorizada con valores y base estadística por período.

GET/api/v1/datasets/{id}/download.csv

Microdatos anonimizados congelados al corte de su versión publicada.

GET/api/v1/datasets/{id}/manifest

Versión, corte, metodología, cantidad de respuestas y huella SHA-256 verificable.

GET/api/v1/reports/{id}

Informe profesional asignado a la organización.

GET/api/v1/official-indicators

Indicadores públicos normalizados y sus últimas 120 observaciones.

ESTADO DEL DATO

Seguimiento en vivo y resultado final no se mezclan

Mientras el trabajo de campo está abierto, X-ARStats-Data-State: live indica que la respuesta puede cambiar y Cache-Control: no-store evita conservarla como publicación. Al cerrar la encuesta, ARStatsDB guarda el JSON exacto y responde X-ARStats-Data-State: published, versión, corte y SHA-256.

El manifiesto de encuesta aparece únicamente para el resultado final publicado.

TRANSFERENCIA EFICIENTE

Descargá solamente cuando cambie la versión

Resultados cerrados, datasets, informes y manifiestos responden con ETag, Last-Modified y la huella de publicación. Conservá el ETag y envialo como If-None-Match; si el recurso no cambió, la API responde 304 Not Modified sin cuerpo.

curl "https://arstatsdb.com/api/v1/datasets/{id}/manifest" \
  -H "X-ARStats-API-Key: arst_live_TU_CLAVE" \
  -H 'If-None-Match: "sha256-HUELLA_ANTERIOR"'

Una respuesta 304 conserva las cabeceras de versión, corte y cuota para que la integración siga siendo auditable.

CUOTAS

Consumo observable

Cada respuesta informa X-RateLimit-Limit, X-RateLimit-Remaining y X-API-Version. La cuota se reinicia al comenzar cada mes UTC.

ERRORES

Respuestas previsibles

401 clave ausente, inválida, vencida o revocada403 suscripción o plan sin acceso404 recurso inexistente o no asignado429 cuota mensual agotada

ESTABILIDAD

Versionado explícito

Los cambios incompatibles se publicarán bajo una nueva ruta mayor. La versión /api/v1 mantendrá nombres y tipos compatibles; podrán agregarse campos sin romper clientes existentes.