고객

중복 확인

가입 전에 중복 고객을 걸러 계정 충돌을 미리 막아요.

회원가입 또는 고객 등록 전에 특정 필드 값의 중복 여부를 확인하는 API예요.

API 엔드포인트

GEThttps://api.bootapi.com/v1/users/join/:key?pk=:valueBasic Auth

요청 파라미터

파라미터 타입 필수 설명
key String 필수 중복 확인 대상 필드
value String 필수 확인할 값 (pk 쿼리로 전달)

key 옵션

key 값 설명 예시
email-exist 이메일 test@bootpay.co.kr
phone-exist 휴대폰 번호 01012345678
id-exist 로그인 아이디 testuser123
uid-exist 외부 고유 ID(ex_uid) user_12345
group-business-number-exist 사업자등록번호 1234567890

코드 예제

curl -H "Content-Type: application/json" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -X GET "https://api.bootapi.com/v1/users/join/email-exist?pk=test@bootpay.co.kr"bash

응답

{
  "exist": false
}json

응답 파라미터

파라미터 타입 설명
exist Boolean 해당 값이 이미 등록되어 있으면 true, 없으면 false

에러 코드

공통 에러

인증·권한 관련 에러는 에러 코드표를 참고해요.

코드 메시지 대처 방법
API_PARAM_INVALID 필수 파라미터를 입력해요 key, pk 값을 확인해요