콘텐츠 수정

04 콘텐츠 수정

4.1 설명

PUT/contents/{id}

고칠 수 있는 칸은 아래 표의 여섯뿐입니다. 그 밖의 값을 보내면 오류 없이 무시되므로, 멱등 식별자(external_id)나 콘텐츠 형태(content_type)는 이 호출로 바꿀 수 없습니다. 여섯 칸 중 하나도 보내지 않으면 400 입니다.

hashtags · platform_metadata · metadata 는 통째로 갈아치웁니다. 일부만 보내면 나머지는 사라지므로, 먼저 조회해 받은 값을 고쳐 그대로 되보내십시오.

platform_metadata 의 모양과 쓸 수 있는 채널 키는 POST /contents 의 설명과 같습니다. 여기서 주의할 것은 갈아치움입니다.

한 줄로 적으면 {"platform_metadata": {"youtube": {"title": "유튜브용"}, "instagram": {"body": "인스타용"}}} 입니다. 여기서 유튜브만 고치려고 {"platform_metadata": {"youtube": {"title": "새 제목"}}} 를 보내면 인스타그램 쪽이 사라집니다. 먼저 GET /contents 로 받은 값을 고쳐 통째로 되보내십시오.

4.2 파라미터

콘텐츠 수정 파라미터
이름	구분	설명
`workspace`	필수	워크스페이스 코드
`title`	선택	공통 제목. 1자 이상 500자 이하
`body`	선택	공통 본문 또는 설명. 10000자 이하
`hashtags`	선택	공통 해시태그. 문자열 60개까지, 한 개는 100자 이하. 통째로 대체됩니다
`language`	선택	언어 코드(`ko` · `en-US` 꼴)
`platform_metadata`	선택	플랫폼별 제목·본문 덮어쓰기. 열쇠는 채널 키, 값은 `title` · `body` 를 담은 객체입니다. 배열이 아니라 객체여야 하고 통째로 대체됩니다
`metadata`	선택	제작 시스템 확장 메타데이터. 배열이 아니라 객체여야 하고 통째로 대체됩니다

4.3 요청

Terminal — bash

curl -X PUT https://moacast.com/api/moacast/v1/contents/{id} \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"workspace":"a1b2c3d4"}'

4.4 성공 응답

Response — JSON

{
    "result": "SUCCESS",
    "result_code": 0,
    "message": "콘텐츠를 수정했습니다.",
    "data": {
        "content": {
            "id": 12,
            "title": "9월 넷째 주 요약 (수정)",
            "language": "ko",
            "hashtags": [
                "주간요약"
            ],
            "publications": []
        }
    }
}

4.5 필드

콘텐츠 수정 필드
필드	타입	설명
`content`	`object`	수정된 콘텐츠. 모양은 `GET /contents` 의 한 줄과 같습니다

4.6 실패

콘텐츠 수정 실패
코드	HTTP	언제
`9912`	400	`workspace` 를 주지 않았습니다
`1004`	400	값이 규칙에 맞지 않거나, 고칠 수 있는 칸을 하나도 보내지 않았습니다
`1001`	401	헤더가 없거나 토큰이 올바르지 않습니다
`1002`	403	정지된 워크스페이스입니다
`1003`	403	세션으로 부른 쓰기인데 요청 출처가 이 사이트가 아닙니다
`2000`	404	그 워크스페이스가 없거나, 그 콘텐츠를 찾을 수 없습니다
`5000`	503	콘텐츠 저장소가 준비되지 않았습니다

응답은 쓰기 뒤에 다시 읽은 콘텐츠입니다. 보낸 값을 되울리지 않습니다.