신규 고객 생성 API

플랫폼 서비스에서 특정 비즈니스에 고객을 생성할 수 있는 API를 제공합니다.

POST kit-api/v1/customers

Method: POST Endpoint: kit-api/v1/customers

Example

.../kit-api/v1/customers

{
  "input": {
    "title": "김철수",
    "customKey": "A5-k159402"
  }
}

Request Body

Key	Description	Required
input.title	한글, 영어 대소문자, 숫자, -, , _, 등으로 구성된 40자 이하의 새로 생성할 고객 이름 (같은 비즈니스 내 중복불가)	yes
input.customKey	새로 생성할 고객에게 할당하고 싶은 영어 대소문자, 숫자, -, _로 구성된 40자 이하의 키 (같은 비즈니스 내 중복불가)	no

Response

{
  "ok": true,
  "message": undefined, // 실패하는 경우 메시지
  "data": {
    "id": 1,
    "title": "김철수",
    "customKey": "A5-k159402"
  }
}

Error Codes

Status Code	Error Code	Description
400	INVALID_CUSTOMER_TITLE	title이 생성 규칙을 벗어난 경우
400	INVALID_CUSTOMER_CUSTOM_KEY	customKey가 생성 규칙을 벗어난 경우
409	DUPLICATED_CUSTOMER_TITLE	해당 title을 가진 고객이 이미 존재하는 경우
409	DUPLICATED_CUSTOMER_CUSTOM_KEY	해당 customKey를 가진 고객이 이미 존재하는 경우
500	FAILED_CREATE_CUSTOMER	고객 생성 과정에서 알 수 없는 에러가 발생한 경우