API 문서

콘텐츠 한 건 조회

콘텐츠 하나를 ID 로 조회합니다. 첨부(assets)와 채널별 예약(publications)이 같이 실립니다.

버전: v1

03 콘텐츠 한 건 조회

3.1 설명

GET/contents/{id}

외부 제작 시스템의 식별자로 찾으려면 GET /contents?external_id=... 를 쓰십시오.

3.2 파라미터

콘텐츠 한 건 조회 파라미터
이름구분설명
workspace필수워크스페이스 코드

3.3 요청

Terminal — bash
curl "https://moacast.com/api/moacast/v1/contents/{id}?workspace=a1b2c3d4" \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

3.4 성공 응답

Response — JSON
{
    "result": "SUCCESS",
    "result_code": 0,
    "data": {
        "content": {
            "id": 12,
            "external_id": "job-2026-0927-01",
            "content_type": "video",
            "title": "9월 넷째 주 요약",
            "assets": [
                {
                    "asset_type": "MASTER_VIDEO",
                    "mime": "video/mp4",
                    "size_bytes": 18234112,
                    "url": "https://…/moacast/3/12/1790000000-ab12cd.mp4?X-Amz-Signature=…",
                    "url_expires_in": 300
                }
            ],
            "publications": []
        }
    }
}

3.5 필드

콘텐츠 한 건 조회 필드
필드타입설명
contentobject콘텐츠 한 건. 모양은 GET /contents 의 한 줄과 같습니다

3.6 실패

콘텐츠 한 건 조회 실패
코드HTTP언제
9912400workspace 를 주지 않았습니다
1001401헤더가 없거나 토큰이 올바르지 않습니다
2000404그 워크스페이스가 없거나, 그 콘텐츠를 찾을 수 없습니다
5000503콘텐츠 저장소가 준비되지 않았습니다

다른 워크스페이스의 콘텐츠 ID 를 넣어도 404 입니다. 「없다」와 「남의 것이다」를 가르지 않습니다 — 가르면 ID 를 찍어 보는 것만으로 남의 콘텐츠가 있는지 알 수 있습니다.