광고연구소

인증번호

OnSureLab

휴대폰 인증번호 발송 및 확인 API입니다.

POST

인증번호 발송

엔드포인트
POST /api/onsurelab/auth/send-code
요청 Body
필드타입필수설명
phonestring
필수
휴대폰 번호 (예: 01012345678)
요청 예시
{
  "phone": "01012345678"
}
성공 응답 (200)
{
  "success": true,
  "data": {
    "message": "인증번호가 발송되었습니다.",
    "expires_at": "2024-01-01T00:05:00.000Z"
  }
}
참고
  • 인증번호는 4자리 숫자입니다.
  • 유효 시간은 5분입니다.
  • 전화번호는 하이픈(-) 없이 숫자만 입력해도 됩니다.
  • 발송 제한: 동일 번호로 5분 내 최대 3회까지만 발송 가능합니다.
POST

인증번호 확인

엔드포인트
POST /api/onsurelab/auth/verify-code
요청 Body
필드타입필수설명
phonestring
필수
휴대폰 번호
codestring
필수
인증번호 (4자리)
요청 예시
{
  "phone": "01012345678",
  "code": "1234"
}
성공 응답 (인증 성공)
{
  "success": true,
  "data": {
    "verified": true,
    "message": "인증이 완료되었습니다."
  }
}
인증 실패 응답

인증번호 불일치

{
  "success": true,
  "data": {
    "verified": false,
    "message": "인증번호가 일치하지 않습니다."
  }
}

만료됨

{
  "success": true,
  "data": {
    "verified": false,
    "message": "유효한 인증 요청이 없거나 만료되었습니다."
  }
}