02 채널 정보 새로 받기
2.1 설명
POST/channels/sync
받는 단위는 계정 하나입니다. 같은 플랫폼에 계정이 둘 이상 연결되어 있으면 external_id 로 어느 계정인지 알려 주어야 합니다. 알려 주지 않으면 400 이고 아무것도 받지 않습니다. 계정이 하나뿐이면 external_id 는 생략할 수 있습니다.
돌려주는 data.channel 한 줄의 모양은 채널 목록과 완전히 같습니다.
2.2 파라미터
| 이름 | 구분 | 설명 |
|---|---|---|
workspace | 필수 | 워크스페이스 코드 |
channel | 필수 | 채널 키입니다. 목록의 channel 값을 그대로 씁니다 |
external_id | 선택 | 정보를 받을 계정입니다. 목록의 external_id 값을 그대로 씁니다. 그 플랫폼에 계정이 둘 이상이면 반드시 주어야 합니다 |
avatar_px | 선택 | 프로필 사진을 그릴 크기(1~1024) |
2.3 요청
curl -X POST https://moacast.com/api/moacast/v1/channels/sync \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{"workspace":"a1b2c3d4","channel":"youtube"}'2.4 성공 응답
{
"result": "SUCCESS",
"result_code": 0,
"message": "...",
"data": {
"workspace": "a1b2c3d4",
"channel": {
"channel": "youtube",
"external_id": "UC...",
"display_name": "My Channel",
"language": "ko"
}
}
}2.5 필드
| 필드 | 타입 | 설명 |
|---|---|---|
workspace | string | 워크스페이스 코드 |
channel | object | 갱신된 연결 한 건. 필드는 채널 목록의 한 줄과 같습니다 |
2.6 실패
| 코드 | HTTP | 언제 |
|---|---|---|
9912 | 400 | 필수 파라미터가 빠졌습니다 |
1004 | 400 | 그 플랫폼에 계정이 둘 이상인데 external_id 를 주지 않았습니다 |
1001 | 401 | 헤더가 없거나 토큰이 올바르지 않습니다 |
2000 | 404 | 그 워크스페이스가 없거나, 그 계정이 연결되어 있지 않습니다 |
4013 | 409 | 채널의 권한이 만료되었거나 다른 계정을 가리킵니다. 다시 연결해야 합니다 |
4290 | 429 | 60초 안에 이미 받았습니다 |
5000 | 502 | 플랫폼에서 정보를 받지 못했습니다. 저장된 값은 그대로 둡니다 |