OpenAPI 사양

Outcome：Complete the task with OpenAPI 사양 (OpenAPI Specification)。 User context：파트너 API는 `POST /claims`와 필요한 멱등성(idempotency) 헤더를 설명합니다. 또한 OAuth 범위, JSON 스키마 규칙, 201 및 문제 응답, 그리고 가짜 데이터를 이용한 예시도 나열합니다. CI는 문서화되지 않은 중단되는 응답을 차단합니다. 생성된 클라이언트는 여전히 검증 없이 신뢰하지 않고 검토됩니다. Technical concept or control：OpenAPI 사양 (OpenAPI Specification)。 Why it fits：사람들이 문서, 검사, 모의 서버, 클라이언트 생성, 호환성 테스트를 검토할 수 있는 계약으로 사용하세요. Do not use it when：생성된 문서는 실제 예제, 인증 테스트, 런타임 검사 또는 명확한 프로덕션 동작을 대체하지 않습니다. 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)：공식 문서라고 해도 초안, 출시 후보, 최종 버전일 수 있어요. 상태와 브라우저나 플랫폼 지원 여부를 꼭 확인하세요. 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.