OpenAPI 명세 다운로드

OOLIN Wallet API의 엔드포인트와 요청·응답 스키마를 OpenAPI 형식으로 제공합니다. 같은 명세를 API Reference에서도 확인할 수 있습니다.

Wallet API OpenAPI JSON 다운로드

다운로드한 명세를 이용해 타입 클라이언트를 생성하거나 요청·응답을 검증하고 API 개발 도구로 가져올 수 있습니다. 운영에서는 검토된 버전에 고정하고 명세 변경을 검토한 뒤 클라이언트를 갱신합니다.

OpenAPI는 전송 스키마와 엔드포인트 계약을 설명합니다. 멱등성, cursor checkpoint, 상태 polling과 대사 방법은 튜토리얼과 연동 가이드를 함께 확인하십시오.

권장 사용 절차

검토한 명세 파일 또는 checksum을 client release와 함께 저장합니다.
CI에서 type을 생성하고 검토되지 않은 breaking change를 실패 처리합니다.
알 수 없는 응답 필드는 forward-compatible하게 무시합니다.
새로운 enum 값과 필수 요청 필드는 별도 검토합니다.
배정받은 비운영 환경에서 contract test를 실행합니다.

생성 예제에 자격 증명을 넣거나 secret이 포함된 API 도구 환경을 commit하지 않습니다. 명세의 server URL은 예시이므로 온보딩 과정에서 전달받은 실제 Base URL로 설정합니다.