시작하기

K-OTP란 무엇인가요?

K-OTP는 신뢰할 수 있는 인증 코드로 애플리케이션을 보호하는 데 도움이 되는 포괄적인 OTP(일회용 비밀번호) 전송 서비스입니다. SMS, 이메일 또는 음성 기반 인증이 필요한지 여부에 관계없이 K-OTP는 필요한 인프라를 제공합니다.

전제 조건

시작하기 전에 다음을 확인하세요:

K-OTP 계정 (k-otp.dev에서 가입)
활성 구독 요금제
REST API에 대한 기본 지식
테스트용 개발 환경

1단계: 계정 만들기

k-otp.dev를 방문하여 "가입"을 클릭하세요
등록 과정을 완료하세요
이메일 주소를 확인하세요
필요에 맞는 구독 요금제를 선택하세요

2단계: API 키 생성

대시보드로 이동하세요
설정 > API 키로 이동하세요
"새 키 생성"을 클릭하세요
API 키를 복사하고 안전하게 저장하세요
보안을 위해 허용된 도메인/IP를 구성하세요

3단계: 첫 번째 OTP 보내기

SMS OTP를 보내는 간단한 예제입니다:

const response = await fetch('https://api.k-otp.dev/v1/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '+8210123456789',
    method: 'sms',
    type: 'verification',
    template: 'default'
  })
});

const result = await response.json();
console.log('OTP ID:', result.id);

4단계: OTP 검증

사용자가 코드를 받으면 검증하세요:

const verifyResponse = await fetch('https://api.k-otp.dev/v1/verify', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    id: result.id,
    code: '123456' // 사용자가 입력한 코드
  })
});

const verifyResult = await verifyResponse.json();
if (verifyResult.valid) {
  console.log('OTP가 성공적으로 검증되었습니다!');
}

통합 테스트

먼저 샌드박스 환경에서 테스트하는 것을 권장합니다:

테스트 API 엔드포인트 사용: https://api-sandbox.k-otp.dev
테스트 전화번호: +8255000XXXX
테스트 이메일: [email protected]

일반적인 통합 패턴

사용자 등록 플로우

사용자가 전화번호/이메일 입력
인증을 위한 OTP 전송
사용자가 받은 코드 입력
OTP 검증 후 계정 생성

2FA 로그인

사용자가 사용자명/비밀번호 입력
두 번째 인증 수단으로 OTP 전송
사용자가 OTP 코드 입력
검증 후 액세스 허용

비밀번호 재설정

사용자가 비밀번호 재설정 요청
등록된 연락처로 OTP 전송
OTP 검증
비밀번호 변경 허용

다음 단계

자세한 보안 옵션은 인증을 살펴보세요
완전한 기능은 API 엔드포인트에서 확인하세요
실시간 알림을 위한 웹훅을 설정하세요
성능 모니터링을 위한 분석을 구성하세요

도움이 필요하세요?

일반적인 질문은 FAQ를 확인하세요
[email protected]로 지원팀에 문의하세요
Discord에서 개발자 커뮤니티에 참여하세요

시작하기

On this page