Interfaz pública de datos

Los datos, abiertos y documentados

Todo lo que SIWA muestra está publicado en archivos JSON que cualquiera puede leer: sin credencial, sin registrarse, sin pedir permiso y sin límite de consultas. Esta página dice qué hay, dónde está y qué se promete de ello.

Cómo se lee

Cada conjunto se descarga de su dirección y responde JSON. Las cabeceras están abiertas —Access-Control-Allow-Origin: *—, así que se puede leer desde una página de otro dominio sin intermediario. El servidor pide que se guarde en memoria diez minutos (max-age=600): respetarlo alcanza y sobra, porque el robot recolecta una vez por hora.

fetch('https://siwa.fundacionkent.org/datos/publico/indice.json')
  .then(r => r.json())
  .then(indice => {
    // el catalogo dice que hay: direccion, fuente, fecha y forma de la fila
    const c = indice.conjuntos.find(x => x.archivo === 'oms_homicidios.json');
    console.log(c.campos_de_la_fila);   // ['iso','pais','bloque','estado','tasa','serie',...]
    return fetch(c.url).then(r => r.json());
  })
  .then(d => {
    console.log(d.procedencia.fuente.nombre);   // de donde sale
    console.log(d.procedencia.obtenido_en);     // de cuando es
    d.registros.forEach(r => console.log(r.iso, r.tasa));
  });

Empezar por indice.json evita escribir a mano cuarenta direcciones y hace que un conjunto nuevo aparezca solo.

Qué trae adentro cada archivo

Dos bloques están en los 102, sin excepción, y son los que conviene programar contra ellos:

Los campos de valor no son los mismos en todos. Un conjunto de homicidios trae tasa y serie; uno de indicadores comparables trae un diccionario indicadores —40 conjuntos lo traen—. En lugar de pedirle a quien consume que abra los 102 archivos para averiguarlo, el catálogo lo declara: cada conjunto lleva campos_de_la_fila con los nombres que efectivamente aparecen, y por_estado para saber si la fila es un Estado.

Además del registro: el padrón de los 33 Estados en GeoJSON y el canal de novedades, que anuncia qué cambió en cada corrida.

Herramientas para usarlo

Al ser JSON plano con cabeceras abiertas, se lee con las librerías habituales de cualquier lenguaje, sin cliente propio:

Verificar que es lo que publicamos

Cada archivo lleva su huella SHA-256 en checksums.txt, en el formato de sha256sum. Quien descarga un conjunto puede recalcular la huella y compararla: si coincide, recibió exactamente lo que la casa publicó. El propio catálogo declara además, en formato máquina, los derechos (titular, licencia y cómo citar), las keywords del registro y el esquema de identificadores (código ISO de Estado y dónde se resuelve).

Lo que se promete, y lo que no

Condición de uso

Uso libre, citando a la Fundación Sherman Kent y a la fuente original de cada dato, que viaja en el propio archivo. SIWA no cobra por esto y no piensa cobrarlo.

3 de los 102 conjuntos llevan además una condición de su fuente, marcada abajo y escrita entera en el campo restriccion_de_uso del archivo: esa condición manda sobre esta página. Se resumen en que el dato no puede viajar a un producto pago sin tomar antes la licencia que corresponda.

Los 102 conjuntos

Si construís algo con esto

Escribinos y lo enlazamos desde el registro. También sirve el camino inverso: si tenés una serie de la región que no está acá, es material para sumar. El registro crece por donde alguien mira.