API Reference
카카오 채널 상세 조회
연결된 채널 하나를 조회합니다. 목록과 달리 카카오 쪽 상태를 실제로 확인하고 status 를 갱신합니다.
채널 연결 요청이 타임아웃됐을 때 결과를 확정하는 경로이기도 합니다 — 연결 요청을 재호출하면 중복 등록을 시도하게 되지만, 이 조회는 몇 번을 불러도 안전합니다.
카카오 쪽 조회에 실패해도 404 가 아닙니다. 연결 기록 자체는 유효하므로 status 를 needs_attention
으로 표시해 돌려줍니다 — 채널이 실제로 끊겼는지, 일시적인 조회 실패인지는 다시 호출해 확인하세요.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
channelId*string
채널 목록에서 받은 ClawOps 채널 리소스 ID. 검색용 ID(example)가 아닙니다.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/kakao/channels/clx9kak0001"{
"id": "clx9kak0001",
"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",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}