API 레퍼런스
OpenAPI 스펙에서 생성한 엔드포인트별 레퍼런스
이 섹션은 OpenAPI 스펙(info.version: 1.2.0)에서 자동 생성됩니다. 필드와 오류 설명은 스펙 원문(영어)을 그대로 사용합니다. 대화형 레퍼런스는 api.k-otp.dev/docs, 스펙 원본은 api.k-otp.dev/openapi/v1.json에서 볼 수 있습니다.
Base URL: https://api.k-otp.dev/v1
| 엔드포인트 | 설명 | 키 | 필요 scope |
|---|---|---|---|
POST /v1/issue | OTP 발급 | pk_ / sk_ | otp:issue |
POST /v1/verify | OTP 검증 | pk_ / sk_ | otp:verify |
GET /v1/status | 발급 상태 조회 | sk_ | otp:status |
GET /v1/issues | 발급 이력 목록 | sk_ | otp:dashboard:read |
GET /v1/issues/{issueId} | 발급 이력 단건 | sk_ | otp:dashboard:read |
GET /v1/credit-ledger | 크레딧 원장 목록 | sk_ | otp:ledger:read |
GET /v1/balance | 잔액 조회 | sk_ | otp:balance |
GET /v1/templates | 템플릿 목록 | sk_ | otp:templates |
GET /v1/templates/{templateId} | 템플릿 상세 | sk_ | otp:templates |