Primeros pasos con la API v1

• Contrato fuente: `Cerca-PWA/packages/contracts/openapi.yaml`
• Prefijo de rutas: `/v1`

La API v1 forma parte de la misma aplicación que sirve la PWA. Empieza por el
contrato OpenAPI para conocer las operaciones, cuerpos, respuestas y esquemas.
Las rutas de API usan nombres en inglés aunque las rutas web de Cerca estén en
español.

Ejemplo de lectura pública:

curl 'https://cerca.red/v1/search?q=cafe'

Las respuestas de listas usan el campo `datos` cuando el contrato lo indica.
Revisa siempre el código HTTP y el tipo de contenido antes de interpretar el
cuerpo. No supongas que un `200` significa que hay resultados: una lista puede
estar vacía.

La audiencia de ayuda Desarrolladores no es un portal separado. No existe una
ruta `/desarrolladores/*` en el producto comprobado; esta guía explica el
contrato v1 que ya expone la PWA.