Conecta tu app a la red

API REST para enviar datos (push), consultarlos (pull) o integrar esta herramienta en tu propia aplicación.

Enviar datos (push)

Consultar datos (pull)

Esquema IndexedRecord

Enviar datos con `POST /api/ingest`

Envía registros de personas, centros o recursos en un único lote autenticado. Necesitas una clave de ingestión (solicítala en /contribuir o directamente al responsable).

Autenticación

Incluye la clave en la cabecera x-ingest-key: TU_CLAVE de cada petición.

Cuerpo de la petición

{
  "source": {
    "id":          "mi-org-unica-id",
    "name":        "Cruz Roja Venezuela",
    "kind":        "ong",
    "description": "Voluntarios activos en el área afectada",
    "url":         "https://cruzroja.org.ve"
  },
  "disaster": "venezuela-2024",
  "records": [
    {
      "id":          "cr-001",
      "record_type": "persona_desaparecida",
      "person_name": "María González",
      "location_name": "Maracaibo, Zulia",
      "age":         "34",
      "summary":     "Vista por última vez el 15/11 en el mercado central.",
      "contact":     "familiar: +58 412 555 0001"
    },
    {
      "id":          "cr-acopio-01",
      "record_type": "centro_acopio",
      "title":       "Centro Comunal Las Mercedes",
      "location_name": "Calle Bolívar 44, Maracaibo"
    },
    {
      "id":          "cr-rec-01",
      "record_type": "recurso",
      "title":       "Agua potable disponible",
      "summary":     "2000 litros listos para distribución",
      "location_name": "Almacén Las Mercedes",
      "tags":        ["agua"]
    }
  ]
}

Tipos de registro (`record_type`)

persona_desaparecida — persona buscada, no localizada
persona_localizada — persona encontrada / a salvo
persona_hospitalizada — persona en centro médico
centro_acopio — punto de acopio de ayuda
centro_donacion — punto de donaciones
recurso — alimentos, medicinas, transporte u otro recurso
otro — cualquier otra categoría

Respuesta

{ "written": 3, "skipped": 0, "disaster": "venezuela-2024" }

Ejemplo con curl

curl -X POST "https://crisisglow.com/api/ingest" \
  -H "x-ingest-key: TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d @lote.json

Upsert automático. Si ya existe un registro con el mismo source_name y nombre/id externo, se actualiza en lugar de duplicarse. Usa source_record_id para identificar de forma estable cada entrada en tu sistema.

Consultar datos

GET /api/records/search

Búsqueda unificada sobre personas, centros y recursos. Sin autenticación.

Parámetro	Tipo	Descripción
q	string	Texto libre (nombre, lugar…)
disaster	string	Slug del desastre (p. ej. `venezuela-2024`)
record_type	string	Filtro de tipo (ver lista en la pestaña Esquema). Omitir = todos.
page	int	Página (defecto: 1)
per_page	int	Resultados por página (máx. 100, defecto: 20)

curl "https://crisisglow.com/api/records/search?q=maria&disaster=venezuela-2024&record_type=persona_desaparecida"

GET /api/sources

Lista de fuentes externas conectadas con recuento de registros y frescura. Sin autenticación.

curl "https://crisisglow.com/api/sources"

{
  "results": [
    {
      "source_name": "Cruz Roja Venezuela",
      "record_count": 342,
      "last_seen_at": "2024-11-17T14:32:00Z",
      "freshness": "al día"
    }
  ],
  "total": 1
}

GET /api/export/pfif?disaster=SLUG

Exporta personas en formato estándar PFIF 1.4 (XML). Compatible con la Cruz Roja, CICR y otras instancias. Ver más en Interoperabilidad.

GET /api/search

Búsqueda de personas (sin centros ni recursos). Mismos parámetros q, disaster, page, per_page. Devuelve el esquema completo de Person.

Esquema IndexedRecord

Campos aceptados por POST /api/ingest y devueltos por GET /api/records/search.

Objeto `source` (obligatorio en /api/ingest)

Campo	Tipo	Descripción
id	string REQ	Identificador único y estable de tu sistema
name	string REQ	Nombre de tu organización (aparece en la página /fuentes)
kind	string	`hospital` \| `ong` \| `gobierno` \| `media` \| `otro`
description	string	Descripción corta de la fuente
url	string	URL principal de tu organización

Objeto `records[]`

Campo	Tipo	Descripción
id	string REQ	ID estable en tu sistema (se usa para upsert)
record_type	string REQ	Ver lista de tipos más arriba
title	string	Título del registro (para centros y recursos)
person_name	string	Nombre completo (para personas)
summary	string	Descripción breve
age	string	Edad aproximada (texto libre: "35", "adulto"…)
location_name	string	Lugar donde fue visto / se encuentra
city	string	Ciudad
state	string	Estado / provincia
country	string	País
contact	string	Información de contacto (se almacena, no se devuelve públicamente para personas)
status	string	Estado según PFIF (`information_sought`, `is_note_author`…)
source_record_id	string	ID alternativo para upsert (si difiere de `id`)
tags	string[]	Etiquetas (la primera se usa como `kind` en recursos)
observed_at	string	Fecha de observación (ISO 8601)
image_url	string	URL de foto (solo informativo, no se descarga)

Nota sobre privacidad. Los campos contact de personas NO se exponen en búsquedas públicas ni en PFIF. Para la comunicación entre familiares existe el proxy POST /api/person/{id}/contact-reporter que reenvía el mensaje sin revelar el contacto directo.

¿Tienes dudas o necesitas una clave de ingestión? Registra tu fuente aquí o contacta al responsable del tratamiento en /privacidad.

Conecta tu app a la red

Enviar datos con POST /api/ingest

Autenticación

Cuerpo de la petición

Tipos de registro (record_type)

Respuesta

Ejemplo con curl

Consultar datos

Esquema IndexedRecord

Objeto source (obligatorio en /api/ingest)

Objeto records[]

Enviar datos con `POST /api/ingest`

Tipos de registro (`record_type`)

Objeto `source` (obligatorio en /api/ingest)

Objeto `records[]`