01 연결한 채널 목록
1.1 설명
GET/channels
계정마다 한 줄입니다. 같은 플랫폼에 계정을 여럿 연결했으면 channel 이 같은 줄이 여러 개 나옵니다. 그 줄들을 가르는 값은 external_id 이고, 예약할 때 어느 계정인지 가리키는 값도 그것입니다.
순서는 채널 정의 순서이고, 같은 플랫폼 안에서는 연결한 차례입니다. 연결하지 않은 채널은 나오지 않습니다.
1.2 파라미터
| 이름 | 구분 | 설명 |
|---|---|---|
workspace | 필수 | 워크스페이스 코드 |
avatar_px | 선택 | 프로필 사진을 그릴 크기(1~1024). 주면 avatar_url_sized 를 그 크기로 만들어 줍니다. 범위를 벗어난 값은 무시하고 원본을 줍니다 |
1.3 요청
curl "https://moacast.com/api/moacast/v1/channels?workspace=a1b2c3d4&avatar_px=88" \
-H 'Authorization: Bearer <ACCESS_TOKEN>'1.4 성공 응답
{
"result": "SUCCESS",
"result_code": 0,
"data": {
"workspace": "a1b2c3d4",
"channels": [
{
"channel": "youtube",
"external_id": "UC...",
"display_name": "My Channel",
"handle": "mychannel",
"language": "ko",
"profile_url": "https://www.youtube.com/channel/UC...",
"avatar_url": "https://yt3.ggpht.com/...",
"avatar_url_sized": "https://yt3.ggpht.com/...=s88-c-k-c0x00ffffff-no-rj",
"permissions": [
"publish",
"read"
],
"status": "ACTIVE",
"connected_by": "moacast",
"connected_at": "2026-09-26 19:28:51",
"stats": {
"followers": 83,
"items": 34,
"views": 34290,
"fetched_at": 1790420673
}
}
]
}
}1.5 필드
| 필드 | 타입 | 설명 |
|---|---|---|
workspace | string | 워크스페이스 코드 |
channels | array | 연결 목록. 한 줄의 모양은 아래와 같습니다 |
channels 의 한 줄
| 필드 | 타입 | 설명 |
|---|---|---|
channel | string | 채널 키입니다. 새로고침과 연결 해제가 이 값을 받습니다 |
external_id | string | 플랫폼에서의 계정 식별자입니다. 같은 플랫폼에 계정이 여럿일 때 이 값으로 계정을 가리킵니다 |
display_name | string | 플랫폼에 표시되는 계정 이름 |
handle | string | 플랫폼에서의 핸들입니다. @ 를 붙이지 않은 값이며, 플랫폼이 주지 않으면 빈 문자열입니다 |
language | string | 이 계정이 맡는 언어(ko · en · pt-br 꼴). 정하지 않았으면 빈 문자열이고, 그 계정은 target_language 로 고를 수 없습니다 |
profile_url | string | 그 계정의 공개 주소입니다. 모르면 빈 문자열입니다 |
avatar_url | string | 저장해 둔 프로필 사진 주소(원본 크기) |
avatar_url_sized | string | avatar_px 로 요청한 크기의 주소입니다. 크기를 주지 않았으면 원본과 같습니다 |
permissions | array | 이 연결로 할 수 있는 일입니다. publish · read · comment · analytics 중에서 나옵니다 |
status | string | ACTIVE 는 지금 쓸 수 있는 상태, NEEDS_RECONNECT 는 다시 연결해야 하는 상태, REVOKED 는 권한이 회수된 상태입니다 |
connected_by | string | 연결한 사용자 |
connected_at | string | 연결한 시각. UTC 기준 YYYY-MM-DD HH:MM:SS |
stats | object | 구독자·항목·조회 수와 받아 둔 시각입니다. 아직 받은 적이 없으면 null 입니다 |
1.6 실패
| 코드 | HTTP | 언제 |
|---|---|---|
9912 | 400 | workspace 를 주지 않았습니다 |
1001 | 401 | 헤더가 없거나 토큰이 올바르지 않습니다 (만료는 4013 · 키 폐기는 4014) |
2000 | 404 | 그 워크스페이스가 없거나, 이 토큰으로 다룰 수 없습니다 |