Spécification OpenAPI

Outcome: Complete the task with Spécification OpenAPI (OpenAPI Specification). User context: Une API partenaire décrit `POST /claims` et son en-tête d'idempotence requis. Elle liste également la portée OAuth, les règles du JSON Schema, les réponses 201 et d'erreur, ainsi que des exemples avec des données factices. L'intégration continue bloque une réponse rompant le contrat qui n'était pas documentée. Les clients générés sont toujours examinés au lieu d'être approuvés sans vérification. Technical concept or control: Spécification OpenAPI (OpenAPI Specification). Why it fits: Utilisez-le comme un contrat que les gens peuvent examiner pour la documentation, les vérifications, les serveurs factices, la génération de clients et les tests de compatibilité. Do not use it when: Les documents générés ne remplacent pas les exemples réels, les tests d'autorisation, les vérifications à l'exécution ou le comportement clair en production. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary): Un document officiel peut quand même être un brouillon, un release candidate, ou la version finale. Vérifie son statut et sa compatibilité avec le navigateur ou la plateforme. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.