메인 콘텐츠로 건너뛰기
POST
고객 등록

인증

Authorization
string
header
필수

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

헤더

Idempotency-Key
string

1~255자 재시도 키. 같은 도입사와 업무 환경에서 같은 키와 같은 본문을 다시 보내면 최초 응답을 상태 코드까지 그대로 돌려준다. 이름과 billing_email을 담은 최초 응답을 기한 없이 보관하므로 그 뒤에 고치거나 보관해도 재전송 응답은 바뀌지 않는다.

본문

application/json
name
string
필수
Maximum string length: 255
billing_email
string<email>

선택 입력. 확정한 인보이스의 청구 메일을 받을 주소. 없으면 빼거나 null

Maximum string length: 254
Pattern: .+@.+\..+
external_id
string
Required string length: 1 - 255

응답

같은 external_id로 이미 등록한 고객. 조회(read) 권한이 없으면 id, external_id, version만 채우고 name, billing_email, created_at, archived_at은 null이다

archived_at
string<date-time> | null

보관 시각. 보관하지 않았거나 read 권한 없이 받은 재등록 응답이면 null

billing_email
string | null

청구 메일을 받을 주소. 등록하지 않았거나 read 권한 없이 받은 재등록 응답이면 null

created_at
string<date-time> | null

등록 시각. read 권한 없이 받은 재등록 응답이면 null

external_id
string
id
string<uuid>
name
string | null

고객명. read 권한 없이 받은 재등록 응답이면 null

version
integer<int64>