Skip to main content

API de VENEZUELA TE BUSCA

La API REST permite a integraciones autorizadas leer y actualizar datos del registro de personas, recursos, reportes e información recibida. La aplicación pública no usa esta API para sus formularios. La web usa acciones internas con Turnstile y validaciones propias. Esta API es para integraciones autorizadas con llaves, controles de acceso y límites de uso.

URL base

La versión es obligatoria. Las rutas sin versión bajo /api no existen y responden 404.

Formato

  • Todas las respuestas JSON incluyen Cache-Control: no-store.
  • Todas las respuestas incluyen X-Request-ID; comparte ese valor al reportar un error para localizar la petición exacta en observabilidad.
  • Las respuestas exitosas usan { "data": ... }.
  • Las listas usan { "data": [...], "pagination": ... }.
  • Los errores simples usan { "error": "..." }.
  • Los errores de validación usan { "errors": { "campo": ["mensaje"] } }.

Recursos disponibles

  • Métricas del registro.
  • Personas desaparecidas o localizadas.
  • Fotos de personas.
  • Información recibida sobre una persona.
  • Reportes de publicaciones.
  • Revisiones de duplicados.
  • Recursos de apoyo, hospitales, refugios y organizaciones.

Referencia

La referencia completa se genera desde docs/api/openapi.yaml y debe actualizarse junto con las rutas, esquemas y pruebas cuando cambie el contrato.