Portal para Desarrolladores

Documentación técnica de la API Pública y Webhooks de TodosUnidos.

Autenticación

¿Cómo solicitar tu API Key?

Para obtener credenciales de acceso para tu plataforma, escríbenos un correo a ayudavenezuela@todosunidos.com o envíanos un mensaje directo a nuestra cuenta oficial de Instagram@ayudavenezuela.todosunidos.

Para proteger la integridad de los datos, el acceso a la API requiere de esta llave de acceso. Debes incluirla en todas las peticiones a través del header:

x-api-key: TU_LLAVE_AQUI

Endpoints REST

GET/api/v1/personas

Retorna el directorio unificado de personas reportadas. Puedes usar el parámetro `?limit=50` (máx 100).

GET/api/v1/personas/:id

Retorna el expediente completo de una persona específica por su UUID.

POST/api/v1/personas

Ingesta un nuevo reporte hacia nuestra base centralizada. Campos requeridos:

{
  "firstName": "Juan",
  "lastName": "Pérez",
  "status": "desaparecido",
  "documentId": "V-12345678",
  "lastSeenLocation": "Chacao"
}

Suscripción a Webhooks

Puedes registrar una URL en nuestro sistema para recibir alertas automáticas (POST) cuando ocurran eventos importantes (ej. nuevo reporte, persona localizada).

POST/api/v1/webhooks

{
  "url": "https://tu-plataforma.com/api/webhook/receiver",
  "events": "person.created" 
}

El payload que enviaremos contendrá un campo `event` y el objeto `data` con la información del reporte.