문서
연동에 필요한 모든 것
가이드로 시작하고, API 레퍼런스를 옆에 띄워 두고, OpenAPI 스펙으로 클라이언트를 생성하세요.
가이드
퀵스타트, 키 종류, 멱등키, 오류 코드, 발송 상태까지 단계별로 설명합니다.
docs.k-otp.devAPI 레퍼런스
모든 엔드포인트의 요청 필드와 응답, 키별로 필요한 scope를 확인하세요.
api.k-otp.dev/docsOpenAPI 3.1 스펙
코드 생성, 목 서버, 계약 테스트에 쓰는 기계 판독용 명세입니다.
openapi/v1.json 받기
세 단계 퀵스타트
- 1
콘솔에 가입하고 서버용 sk_ 시크릿 키(또는 허용 Origin을 지정한 pk_ 퍼블릭 키)를 만드세요.
- 2
휴대폰 번호, 용도(purpose), 멱등키와 함께 POST /v1/issue를 호출하고 issueId를 보관하세요.
- 3
issueId와 사용자가 입력한 코드로 POST /v1/verify를 호출하세요. verified: true면 인증 완료입니다.
SDK
공식 SDK는 npm의 패키지 하나, @k-otp/sdk입니다. 브라우저·서버 클라이언트, React, Vue, Svelte 바인딩, 완성형 인증 폼을 제공합니다. npm i @k-otp/sdk로 설치하거나 어떤 HTTP 클라이언트로든 REST API를 호출할 수 있습니다. 기준은 REST API입니다.