메인 콘텐츠로 건너뛰기
POST
/
v1
/
customers
고객 생성
curl --request POST \
  --url https://xapi.bolta.io/v1/customers \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identificationNumber": "<string>",
  "organizationName": "<string>",
  "representativeName": "<string>",
  "taxRegistrationId": "<string>"
}
'
{
  "customerKey": "<string>",
  "identificationNumber": "<string>",
  "organizationName": "<string>",
  "representativeName": "<string>",
  "taxRegistrationId": "<string>",
  "certificate": {
    "issuedAt": "<string>",
    "expiresAt": "<string>"
  }
}

인증

Authorization
string
header
필수

API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요.

본문

application/json
identificationNumber
string
필수

사업자등록번호

예시:

"1234567890"

organizationName
string
필수

상호명

Required string length: 1 - 100
representativeName
string
필수

대표자명

Required string length: 1 - 50
taxRegistrationId
string

종사업장번호

Required string length: 4
예시:

"0001"

"0002"

응답

customerKey
string
필수

고객 식별 키

identificationNumber
string
필수

사업자등록번호

예시:

"1234567890"

organizationName
string
필수

상호명

Required string length: 1 - 100
representativeName
string
필수

대표자명

Required string length: 1 - 50
taxRegistrationId
string

종사업장번호

Required string length: 4
예시:

"0001"

"0002"

certificate
object