API Reference
카카오 채널 상세 조회
연결된 채널 하나를 조회합니다. 목록과 달리 카카오 쪽 상태를 실제로 확인하고 status 를 갱신합니다.
채널 연결 요청이 타임아웃됐을 때 결과를 확정하는 경로이기도 합니다 — 연결 요청을 재호출하면 중복 등록을 시도하게 되지만, 이 조회는 몇 번을 불러도 안전합니다.
카카오 쪽 조회에 실패해도 404 가 아닙니다. 연결 기록 자체는 유효하므로 status 를 needs_attention
으로 표시해 돌려줍니다 — 채널이 실제로 끊겼는지, 일시적인 조회 실패인지는 다시 호출해 확인하세요.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
channelId*string
카카오 채널 식별자(channelId). 검색용 ID(example)가 아닙니다.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/kakao/channels/KA01PF250101000000000abcdefg"{
"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"
}