OpenAPI et Postman

Spec OpenAPI

La spec OpenAPI 3.1 canonique est servie en direct à :

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

Elle est régénérée à chaque déploiement à partir des route handlers réels, donc elle ne dérive jamais du comportement de production. Utilisez-la pour :

• Générer des clients dans n'importe quel langage (openapi-generator-cli generate -i openapi.yaml -g python)
• Lancer un serveur mock (prism mock openapi.yaml)
• Faire un diff contre votre dernière copie vendorée en CI

Parcourir

La visionneuse Scalar rend la spec comme une documentation interactive à :

https://api.eveses.com/docs

Essayez les endpoints directement dans le navigateur en collant votre clé API dans la boîte d'auth.

Postman

Importez la collection (générée à partir de la même spec) :

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

Elle est livrée avec les variables d'environnement eveses_api_key et eveses_base_url. Définissez-les une fois — toutes les requêtes sont préremplies.

Versioning

La spec actuelle est v1. Nous ne cassons jamais les endpoints v1 — les ajouts sont rétrocompatibles. Une future v2 coexistera avec v1 au moins 12 mois avant la dépréciation.

Abonnez-vous à /changelog/api pour être notifié des ajouts.