콘솔 가이드

콘솔(app.k-otp.dev)은 K-OTP 앱과 키, 사용량, 크레딧을 관리하는 곳입니다.

앱

앱은 K-OTP를 사용하는 기본 단위입니다. 서비스(또는 환경)마다 앱을 하나씩 만드는 것을 권장합니다. 예를 들어 운영과 스테이징을 다른 앱으로 나누면 키와 크레딧, 발급 이력이 섞이지 않습니다.

앱에 속하는 것:

• API 키(pk_, sk_)
• 크레딧 지갑(앱의 모든 키가 공유)
• 발급 이력과 크레딧 원장

키

앱 안에서 용도별로 키를 발급합니다.

• 서버용 sk_ 키 — 필요한 scope만 선택합니다. 발급·검증만 하는 서버라면 otp:issue, otp:verify, 관리 화면이나 정산 배치라면 otp:dashboard:read, otp:ledger:read, otp:balance 등을 추가합니다.
• 브라우저용 pk_ 키 — otp:issue, otp:verify만 가질 수 있으며, 호출을 허용할 Origin을 정확히 등록해야 합니다(예: https://www.example.com). 와일드카드는 지원하지 않습니다.

키 값은 비밀번호처럼 다루세요. 교체·폐기 절차와 반영 시간(최대 약 60초)은 인증 › 키 교체와 폐기를 참고하세요.

사용량

콘솔에서 발급 이력과 발송·검증 상태를 확인할 수 있습니다. 같은 데이터는 API로도 조회할 수 있습니다.

• 발급 이력: GET /v1/issues, GET /v1/issues/{issueId}
• 단건 상태: GET /v1/status

이력에는 전화번호, 인증번호, 멱등 키, metadata 같은 민감 정보가 포함되지 않습니다.

크레딧

콘솔에서 크레딧을 충전하고 잔액과 변동 내역을 확인합니다. 잔액이 부족하면 발급이 402 PAYMENT_REQUIRED로 거절되므로, 사용량에 맞춰 여유 있게 충전해 두세요. 자세한 내용은 크레딧과 결제를 참고하세요.