Skip to main content
POST
식별자로 고객 조회 또는 생성

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Body

application/json

찾거나 만들 고객의 식별자입니다. 하나 이상 필요합니다.

공개 식별자 필드로 고객 한 명을 찾거나 만드는 요청입니다.

phone_number
string | null
required

고객 전화번호입니다. 한국 표준 형식으로 정규화합니다.

email
string | null

고객 이메일입니다. 검증하고 소문자로 바꾼 뒤 사용합니다.

external_id
string | null

호출자가 관리하는 외부 고객 식별자입니다.

Required string length: 1 - 255

Response

성공 응답

찾거나 만든 고객과 생성 여부를 담은 결과입니다.

customer
CustomerResponse · object
required

찾거나 만든 고객입니다.

created
boolean
required

이 요청에서 고객을 새로 만들었으면 true, 기존 고객을 재사용했으면 false입니다.