API Reference
카카오 채널 목록 조회
이 계정에 연결된 카카오 비즈니스 채널을 조회합니다. 다른 계정의 채널은 나타나지 않습니다.
카카오 쪽 상태를 매번 확인하지는 않습니다. 목록은 ClawOps 에 저장된 연결 정보를 그대로 돌려주므로 빠릅니다.
실제 채널 상태까지 확인하려면 채널 상세 조회를 호출하세요 — 그 호출이 상태를 재확인하고 status 를 갱신합니다.
인증번호만 요청하고 연결을 완료하지 않은 시도는 채널로 잡히지 않습니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
Query Parameters
status?string
연결 상태 필터. 미지정 시 전체.
Default
"all"Value in
"connected" | "needs_attention" | "all"page?integer
페이지 번호(0-based)
Default
0pageSize?integer
페이지 크기(최대 100)
Default
20Range
value <= 100page_size?integerDeprecated
pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.
Range
value <= 100limit?integerDeprecated
pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.
Range
value <= 100Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/kakao/channels?status=connected&page=0&pageSize=20&page_size=50&limit=100"{
"data": [
{
"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"
}
],
"meta": {
"page": 0,
"pageSize": 0,
"total": 0
}
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}