El Atlas expone su información por una API de solo lectura, versionada y documentada, para que otras organizaciones la usen desde sus propios sistemas: plataformas de evaluación, hojas de cálculo, paneles. La versión vigente es v1 y no se rompe: lo que cambie irá en una versión nueva.
Dirección y especificación
- Base:
https://api.atlasdevalorsocial.cl/v1 - Especificación OpenAPI 3.1:
https://api.atlasdevalorsocial.cl/v1/openapi.json - Índice con todas las rutas:
https://api.atlasdevalorsocial.cl/v1/
Mientras el dominio se activa, la misma API responde en https://pgagyunvaazsjlieaaqw.supabase.co/functions/v1/api/v1.
Niveles de acceso
| Nivel | Qué entrega | Cómo se accede |
|---|---|---|
| Público | Lo mismo que muestra el sitio: resúmenes y metadatos de las fichas, evidencia citada, familias, métodos, parámetros oficiales por país, estructura de las reglas de descuento, documentos con resumen | Sin llave |
| Organización | Además: valor central, rangos, fórmula, variables, parámetros libres, factores de transferencia, reglas de descuento con sus cifras | Con llave de organización |
| Interno | Lo del área privada | No sale por la API |
Para obtener una llave, escriba a atlas@atlasdevalorsocial.cl con el nombre de la organización, un contacto y para qué se conectará. Las llaves se entregan por un canal seguro, se ven una sola vez y se pueden revocar.
Autenticación
La llave viaja en la cabecera Authorization:
curl -H "Authorization: Bearer atlas_…" https://api.atlasdevalorsocial.cl/v1/yoTambién se acepta en x-api-key. Nunca va en la dirección ni en el cuerpo. Guárdela como cualquier secreto; si se filtra, avise y se revoca.
Rutas
| Ruta | Qué devuelve | Filtros |
|---|---|---|
GET /v1/ |
Índice y nivel de acceso | |
GET /v1/yo |
Organización, nivel y límite de la llave | |
GET /v1/proxies |
Fichas de proxy | familia, metodo, pais, q |
GET /v1/proxies/{codigo} |
Una ficha, por ejemplo PX-CL-0013 |
|
GET /v1/familias |
Familias académicas F1 a F7 | |
GET /v1/metodos |
Métodos | |
GET /v1/catalogos |
Ejes y códigos del Atlas | eje |
GET /v1/parametros |
Parámetros oficiales por país (capa 0) | pais, codigo, bloque, q |
GET /v1/reglas-descuento |
Reglas de descuento | familia, filtro |
GET /v1/documentos |
Estados del arte y documentos con resumen | tipo, familia |
GET /v1/cambios |
Qué cambió desde una fecha, para sincronizar | desde (ISO 8601), tipo |
Toda lista se pagina con limite (1 a 500, 100 por defecto) y pagina (desde 1), y responde con esta forma:
{ "version": "v1", "nivel": "organizacion", "total": 296, "pagina": 1, "limite": 100, "datos": [ … ], "generado_en": "2026-10-22T13:00:00Z" }Ejemplos
Las fichas de la familia F4 en Chile, nivel público:
curl "https://api.atlasdevalorsocial.cl/v1/proxies?familia=F4&pais=CL"Una ficha completa, nivel organización, en Python. Los campos de cada nivel se describen más abajo y en la especificación OpenAPI:
import requests
r = requests.get("https://api.atlasdevalorsocial.cl/v1/proxies/PX-CL-0013",
headers={"Authorization": "Bearer atlas_…"})
ficha = r.json()["datos"]
print(ficha["nombre"], ficha["moneda_base"], ficha["anio_base"])Sincronizar solo lo que cambió desde la última vez, en JavaScript:
const r = await fetch("https://api.atlasdevalorsocial.cl/v1/cambios?desde=2026-10-01T00:00:00Z", {
headers: { Authorization: "Bearer atlas_…" },
});
const { datos } = await r.json(); // [{ tipo: "proxy", codigo: "PX-CL-0013", cambiado_en: "…" }, …]Qué trae una ficha en el nivel organización
Además de lo público: la fórmula y sus variables, el valor central y el rango, la moneda y el año base, la cuenta y la unidad temporal del valor, los descuentos incorporados, cuándo aplica y cuándo no, los resguardos y las alternativas descartadas, los parámetros oficiales con la transformación de cada variable, los parámetros libres con su fuente y licencia, las transferencias con sus ajustes y el error esperado, los componentes con su valor y la evidencia citada (tipo, referencia, año, nivel, DOI y dirección). Los nombres exactos de cada campo están en la especificación OpenAPI, en el esquema ProxyOrganizacion.
No vienen, a propósito:
- el estado interno de la ficha y de cada regla de descuento, ni las clasificaciones internas del Atlas (su familia propia y la dimensión de Triple Impacto): son del circuito de producción;
- las notas de la evidencia y de los componentes: vuelven ficha por ficha a medida que la revisión del programa de validación las deje escritas, con la misma regla que lo público;
- la fecha de la última revisión va solo cuando la ficha lleva la marca «Revisado por pares»; si no, llega vacía.
Errores y límites
Los errores llegan en JSON con un código estable y un mensaje en palabras:
{ "error": { "codigo": "llave_invalida", "mensaje": "La llave no existe o fue revocada." } }| HTTP | Código | Cuándo |
|---|---|---|
| 401 | llave_invalida, sin_llave |
La llave no existe, fue revocada o la ruta la exige |
| 403 | organizacion_suspendida |
La organización no está activa |
| 404 | no_existe, recurso_desconocido, version_desconocida |
El código o la ruta no existen |
| 429 | limite_superado |
Se superó el límite por minuto de la organización; la respuesta trae Retry-After |
| 429 | limite |
Sin llave, se superaron las 60 llamadas por minuto desde una misma dirección IP; la respuesta trae Retry-After con los segundos que faltan |
Cada organización tiene un límite de llamadas por minuto, acordado al registrarse. Sin llave, el límite es de 60 llamadas por minuto por dirección IP. La dirección se usa solo para contar ese límite y no se guarda más de un minuto (ver la política de privacidad). Las respuestas públicas se pueden guardar en caché cinco minutos; las de organización, no. En el nivel público, el total de una lista se recalcula cada cinco minutos.
Condiciones
El uso de la API se rige por los términos de uso y la licencia de contenido: el nivel público bajo CC BY-NC-SA 4.0 con atribución al Atlas; el nivel organización, para uso en las evaluaciones, informes y sistemas de la organización, sin redistribución en bruto.