API Reference
카카오 채널 연결
담당자 휴대전화로 받은 인증번호로 채널 연결을 완료합니다. 먼저 인증번호 요청을 호출해야 합니다.
앞 단계에서 보낸 searchId 와 phoneNumber 를 여기서 다시 보냅니다 — 서버는 등록 도중 상태를 저장하지 않습니다
(미완료 상태의 담당자 전화번호를 남기지 않기 위해서입니다).
멱등입니다. 이미 이 계정에 연결된 채널이면 인증번호를 소모하지 않고 기존 연결을 200 으로 돌려줍니다.
새로 연결된 경우에만 201 입니다. 다른 계정에 이미 연결된 채널이면 멱등이 아니라 충돌이므로 409 입니다.
타임아웃되면 이 요청을 다시 보내지 마세요. 이미 연결에 성공했을 수 있어 중복 등록을 시도하게 됩니다. 대신 채널 목록이나 상세 조회로 실제 등록 여부를 확인한 뒤 결과를 확정하세요.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/kakao/channels" \ -H "Content-Type: application/json" \ -d '{ "searchId": "example", "phoneNumber": "010-1234-5678", "categoryCode": "00100010001", "token": "394812" }'{
"id": "clx9kak0001",
"channelId": "KA01PF250101000000000abcdefg",
"searchId": "example",
"name": "러너스 고객센터",
"categoryCode": "00100010001",
"status": "connected",
"managerPhoneMasked": "010-****-5678",
"connectedAt": "2019-08-24T14:15:22Z",
"syncedAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}{
"id": "clx9kak0001",
"channelId": "KA01PF250101000000000abcdefg",
"searchId": "example",
"name": "러너스 고객센터",
"categoryCode": "00100010001",
"status": "connected",
"managerPhoneMasked": "010-****-5678",
"connectedAt": "2019-08-24T14:15:22Z",
"syncedAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}