API abierta

Datos abiertos, deduplicados y sin PII. Esta API es la columna vertebral para que otras apps y bots consuman la información consolidada. CORS abierto · solo lectura para los datos.

Método	Endpoint	Descripción
`GET`	`/api/people?q=&status=&limit=&offset=`	Deduplicated golden persons (PII-free)
`GET`	`/api/people/{id}`	Single golden person + original sources
`GET`	`/api/buildings?severity=&q=`	Deduplicated damaged buildings
`GET`	`/api/aid?type=&q=`	Collection centers, shelters, machinery, volunteers, pets
`GET`	`/api/risk-overlay?radius=500`	Digital-twin: red/collapsed buildings × nearby missing persons
`GET`	`/api/health`	Per-source ingestion health
`GET`	`/api/analytics?days=30`	Public aggregate dashboard: trends, zones, family clusters, pipeline
`GET`	`/api/openapi.json`	Full OpenAPI 3.1 specification
`POST`	`/api/reports/people`	Submit a missing/found person report
`POST`	`/api/reports/buildings`	Submit a structural-damage report
`POST`	`/api/reports/aid`	Submit an aid-point / shelter report

Ejemplo

curl "$BASE/api/people?status=missing&q=berroteran" | jq

# Spec completa
curl "$BASE/api/openapi.json" | jq

Exportar y feeds (CSV / GeoJSON)

Los endpoints de listado aceptan format=csv o format=geojson, combinables con todos los filtros. Filtros adicionales: ageMin/ageMax (people) y updatedSince (ISO 8601, para sincronización incremental). Sin API key el tope es 1.000 filas por descarga.

# Menores desaparecidos en La Guaira, como GeoJSON
curl "$BASE/api/people?status=missing&ageMax=17&zone=guaira&format=geojson"

# Novedades desde tu última corrida (sync incremental)
curl "$BASE/api/people?updatedSince=2026-07-01T00:00:00Z&format=csv" -o updates.csv

Para ONGs — API keys

Una API key sube los límites (10.000 filas por página, paginación sin tope, sin rate limit) para export masivo y feeds automatizados. No agrega campos: la superficie sigue siendo la misma, sin cédulas ni datos de contacto. Solicita una key escribiendo al equipo (ver pie de página) indicando organización y caso de uso; se envía una sola vez y puede revocarse.

curl -H "X-API-Key: vzla_..." \
  "$BASE/api/people?status=missing&format=csv&limit=10000" -o missing.csv

Conectar por MCP

Los mismos datos, expuestos como tools para agentes (Claude Code, Claude Desktop, claude.ai). Agrega un servidor MCP remoto apuntando a:

$BASE/api/mcp

Requiere una API key (ver sección de arriba): enviala en el header X-API-Key al conectar el servidor MCP en tu cliente.

Trae 10 tools — una por endpoint — con validación y descripciones pensadas para que un agente sepa cuándo usar cada una, incluyendo el envío de reportes (con confirmación humana antes de enviar).

openapi.json →