Inicio

API pública v1

Interoperabilidad para plataformas aliadas

API de integración

Esta API permite que plataformas aliadas (ONGs como CECODAP, Cruz Roja, hospitales, autoridades y medios) consulten y envíen información al sistema Resguardo Infantil VE para mantener los datos sincronizados y evitar duplicidad e inconsistencias entre sistemas. Es REST sobre HTTPS y devuelve JSON.

Principios de privacidad

  • No exponemos fotos ni ubicaciones exactas de los niños.
  • No exponemos datos personales de familias reclamantes.
  • Los endpoints de escritura requieren llave de socio autorizado.
  • Todo uso queda en bitácora inmutable de auditoría.

URL base

https://resguardoinfantil.com/api/public/v1

Autenticación

Endpoints de lectura son públicos. Endpoints de escritura requieren API key emitida por el equipo. Solicítela escribiendo a contacto@resguardoinfantil.com indicando su organización y caso de uso.

Authorization: Bearer rive_xxxxxxxxxxxxxxxxxxxxxxxx
Idempotency-Key: <uuid-opcional-para-evitar-duplicados>

Endpoints

GET/healthscope: público
Health check. Útil para monitoreo.
GET/childrenscope: público

Listado paginado de niños públicos. Mismos campos que /buscar.

Query params:

  • limit (1–500, default 100)
  • cursor — ISO datetime, paginación descendente por created_at
  • updated_since — ISO datetime, para sincronización incremental
  • gender — masculino | femenino | no_especificado
  • state — estado de Venezuela
curl https://resguardoinfantil.com/api/public/v1/children?limit=50&updated_since=2026-06-01T00:00:00Z
GET/children/{caseCode}scope: público
Ficha pública individual por código de caso (ej. VEN-2026-00012).
GET/centersscope: público
Centros de acogida activos.
GET/statsscope: público
Conteos agregados por estado del caso.
POST/citizen-reportsscope: write_reports

Crear un reporte ciudadano desde una plataforma aliada. Entra al mismo flujo de verificación que los reportes hechos en /reportar.

curl -X POST https://resguardoinfantil.com/api/public/v1/citizen-reports \
  -H "Authorization: Bearer rive_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f9a..." \
  -d '{
    "reporter_name": "Dr. Juan Pérez",
    "reporter_email": "jperez@hospital.org",
    "child_description": "Niño ~5 años, camisa roja, encontrado en...",
    "estimated_age": 5,
    "gender": "masculino",
    "sighting_location": "Av. Bolívar con Calle 10",
    "sighting_city": "Caracas",
    "sighting_state": "Distrito Capital"
  }'

Especificación OpenAPI

Descargue la especificación completa para generar clientes automáticamente:

openapi.json

Política de uso