OpenAPI y Postman

OpenAPI spec

La spec OpenAPI 3.1 canónica se sirve en vivo en:

https://api.eveses.com/docs/openapi.yaml

Se regenera en cada despliegue desde los route handlers reales, así nunca diverge del comportamiento de producción. Úsala para:

• Generar clientes en cualquier lenguaje (openapi-generator-cli generate -i openapi.yaml -g python)
• Levantar un servidor mock (prism mock openapi.yaml)
• Hacer diff contra tu última copia vendoreada en CI

Visualiza

El visor Scalar renderiza la spec como documentación interactiva en:

https://api.eveses.com/docs

Prueba endpoints directamente en el navegador pegando tu clave API en el cuadro de auth.

Postman

Importa la colección (generada desde la misma spec):

https://api.eveses.com/docs/eveses.postman_collection.json

Viene con variables de entorno eveses_api_key y eveses_base_url. Configúralas una vez — todas las peticiones quedan pre-rellenadas.

Versionado

La spec actual es v1. Nunca rompemos los endpoints v1 — las adiciones son backward-compatible. Una futura v2 convivirá con v1 al menos 12 meses antes del deprecation.

Suscríbete a /changelog/api para ser notificado de adiciones.