> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venezuelateayuda.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Cómo usar la API de VENEZUELA TE BUSCA.

# 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

```txt theme={null}
https://api.venezuelateayuda.com/v1
```

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.