채널 연결 해제

03 채널 연결 해제

3.1 설명

DELETE/channels

끊는 단위는 계정 하나입니다. 같은 플랫폼에 계정이 둘 이상 연결되어 있으면 external_id 로 어느 계정인지 알려 주어야 합니다. 알려 주지 않으면 400 이고, 이때는 권한 회수도 삭제도 하지 않습니다. 계정이 하나뿐이면 external_id 는 생략할 수 있습니다.

되돌릴 수 없습니다. 다시 쓰려면 앱의 채널 화면에서 동의 절차를 다시 거쳐야 합니다.

3.2 파라미터

채널 연결 해제 파라미터
이름	구분	설명
`workspace`	필수	워크스페이스 코드
`channel`	필수	채널 키입니다. 목록의 `channel` 값을 그대로 씁니다
`external_id`	선택	끊을 계정입니다. 목록의 `external_id` 값을 그대로 씁니다. 그 플랫폼에 계정이 둘 이상이면 반드시 주어야 합니다

3.3 요청

Terminal — bash

curl -X DELETE https://moacast.com/api/moacast/v1/channels \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"workspace":"a1b2c3d4","channel":"youtube"}'

3.4 성공 응답

Response — JSON

{
    "result": "SUCCESS",
    "result_code": 0,
    "message": "...",
    "data": {
        "workspace": "a1b2c3d4",
        "channel": "youtube",
        "external_id": "UC..."
    }
}

3.5 필드

채널 연결 해제 필드
필드	타입	설명
`workspace`	`string`	워크스페이스 코드
`channel`	`string`	해제한 채널 키
`external_id`	`string`	해제한 계정의 식별자입니다. 생략해서 불렀을 때 어느 계정이 끊겼는지 알 수 있습니다

3.6 실패

채널 연결 해제 실패
코드	HTTP	언제
`9912`	400	필수 파라미터가 빠졌습니다
`1004`	400	그 플랫폼에 계정이 둘 이상인데 `external_id` 를 주지 않았습니다. 아무것도 끊기지 않았습니다
`1001`	401	헤더가 없거나 토큰이 올바르지 않습니다
`2000`	404	그 워크스페이스가 없거나, 그 계정이 연결되어 있지 않습니다
`5000`	500	연결을 해제하지 못했습니다

연결을 새로 만드는 API 는 없습니다. 플랫폼의 동의 화면을 브라우저로 직접 거쳐야 하므로, 연결은 앱의 채널 화면에서만 할 수 있습니다.