API abierta

Quién puede qué

Una regla simple: lee todo el mundo; escribe y verifica solo quien aprobamos. A cada socio le emitimos una llave (x-api-key) tras coordinar — no hay alta automática ni escritura anónima. El rol de la llave define qué hace:

Escribir no es verificar. Muchos alimentan; solo los verificadores (clínicos, contactos oficiales) dan fe, acotados a su lugar. Cada ficha verificada guarda verificado_por y verificado_at, para saber siempre quién confirmó qué.

Personas

Registro consolidado de personas (desaparecidos, a salvo y encontrados), incluido lo que reunimos de plataformas hermanas y lo que extraemos con IA de las listas de hospitales y clínicas. Solo lo que ya es público en Buscar.

GET https://venezuelareporta.org/api/v1/personas

{
  "ok": true,
  "atribucion": "Venezuela Reporta — venezuelareporta.org",
  "generado_at": "2026-06-27T12:00:00.000Z",
  "total": 1240,
  "limit": 100,
  "offset": 0,
  "personas": [
    {
      "id": "uuid",
      "status": "buscando",
      "nombre": "María Pérez",
      "cedula": "V-12345678",
      "genero": "femenino",
      "edad": 34,
      "ciudad": "Caracas",
      "zona": "El Valle",
      "ultima_vez": "Cerca de la estación del metro",
      "descripcion": "...",
      "foto_url": "https://.../fotos/...jpg",
      "origen": "venezuelatebusca",
      "verificado": false,
      "created_at": "2026-06-26T11:30:00.000Z",
      "ficha_url": "https://venezuelareporta.org/reporte/uuid"
    }
  ]
}

Las fichas duplicadas se excluyen: solo devolvemos la canónica. Usa id, cedula u origen para cruzar con tus datos, y enlaza a ficha_url para que una familia pueda contactar.

Centros de acopio y clínicas

Estado en vivo y consolidado de sitios (acopio, clínica, hospital, refugio) a partir de reportes de voluntarios en el terreno. Sin datos personales.

GET https://venezuelareporta.org/api/v1/sitios

Detalle de un sitio (con check-ins publicados): GET /api/v1/sitios/{id}.

Listas de hospitales (aportadas)

Personas que aparecen en listados de hospitales, refugios y centros de acopio que la comunidad nos comparte. Sin estado: cada fila solo refleja dónde aparece la persona (su ubicación) y de qué listado salió. Aparecer en una lista no confirma que esté a salvo —eso lo decide la familia o el propio lugar—.

GET https://venezuelareporta.org/api/v1/ingresos

{
  "ok": true,
  "atribucion": "Venezuela Reporta — venezuelareporta.org",
  "nota": "Listas aportadas por la comunidad. SIN estado: aparecer en un listado NO confirma que la persona esté a salvo.",
  "total": 1391,
  "limit": 100,
  "offset": 0,
  "personas": [
    {
      "id": "uuid",
      "nombre": "María Pérez",
      "cedula": "V-12••••78",
      "edad": 34,
      "sexo": "f",
      "procedencia": "Catia La Mar",
      "ubicacion": "Hospital Vargas",
      "fecha": "25/6/26 pm",
      "recopilado_de": "Listado aportado por la comunidad (hospital, refugio o centro de acopio).",
      "fuente": "consolidado-25jun26",
      "ficha_url": "https://venezuelareporta.org/reporte/uuid",
      "created_at": "2026-06-26T11:30:00.000Z"
    }
  ]
}

La cédula se entrega parcial y los apellidos de menores se ocultan, igual que en el resto del sitio. Si la persona ya tiene ficha en el registro, ficha_url enlaza de vuelta para contactar.

Alimentar el registro (escritura)

Cualquiera lee; escriben solo los socios a los que les emitimos una llave (no hay escritura anónima). Si tu plataforma quiere volcar su lista al registro común, escríbenos y coordinamos una llave. Luego envías por POST con la cabecera x-api-key.

POST https://venezuelareporta.org/api/v1/personas
x-api-key: <tu-llave>
Content-Type: application/json

{
  "status": "buscando",          // buscando | a_salvo | encontrado
  "nombre": "María Pérez",
  "ciudad": "Caracas",
  "cedula": "V-12345678",        // opcional
  "genero": "femenino",          // opcional
  "edad": 34,                     // opcional
  "zona": "El Valle",            // opcional
  "ultima_vez": "...",           // opcional
  "descripcion": "...",          // opcional
  "origen_id": "tu-id-estable"   // recomendado: idempotencia
}

• Idempotente: reenviar el mismo origen_id actualiza la ficha, no la duplica. Tus fichas quedan atribuidas a tu entidad en origen.
• Según el rol de tu llave: una plataforma fuente o verificador entra directa (201 publicado); un reportero de campo queda pendiente de que la revisemos (202 pendiente). Una llave verificadora deja la ficha marcada como verificada.
• Privado por defecto: el contacto es opcional y no se publica. No se acepta el estado «fallecido».
• 401 sin llave · 403 llave sin permiso de escritura · 400 datos inválidos · 429 límite.