고객

중복 확인

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

v1 API 상세: 회원

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

API 엔드포인트

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

필요 권한: user:user_check_exist

요청 파라미터

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

key 옵션

key 값 설명 예시
email-exist 이메일 test@bootpay.co.kr
phone-exist 휴대폰 번호 (로그인용 휴대폰 값이 저장된 회원만 찾아요 — 고객 등록 API 로 만든 고객은 이 값이 없어 false 예요) 01012345678
id-exist 로그인 아이디 testuser123
uid-exist 외부 고유 ID(ex_uid) user_12345
group-business-number-exist 사업자등록번호 1234567890

email-exist·id-exist·phone-exist 는 회원(member)만 확인해요. email-exist 는 로그인 이메일 기준이에요.

코드 예제

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,
  "data": null
}json

응답 파라미터

파라미터 타입 설명
exist Boolean 해당 값이 이미 등록되어 있으면 true, 없으면 false
data Object group-business-number-exist 로 찾은 그룹 정보. 다른 key 는 항상 null

에러 코드

공통 에러

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

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