contentsholder/posts.update

作成した記事を更新

URL

POST /v1.0/contentsholder/posts.update

パラメータ

名前 必須 デフォルト値 説明
post_id 必須 - 更新したい記事のID
title 任意 - タイトル
subtitle 任意 - サブタイトル(脇見出し)
status 任意 - 公開・非公開の設定。下書き(非公開)にしておくならdraft、公開するならpublicを指定。
body 任意 - 本文。最大文字数は10,000文字まで。使用できる表現は「Markdown仕様書」を参照。
source_url 任意 - 記事の自社サイト上でのURL
published_at 任意 - 公開日時。値が現在より過去の日時なら、その日時で即公開。値が未来の日時なら、その日時での公開予約。
expired_at 任意 - 公開終了日時。デフォルトの公開終了日時は、公開日時から、nor.cmsの「記事の有効期限」(default_post_expire_days)に設定した日数が経過した時点の日時。空文字の場合は公開終了設定なし。
labels 任意 - 付与するラベル。カンマ "," 区切りで複数のラベル付与が可能。空文字の場合はラベルを付与しない。
tags 任意 空文字 付与するタグ。カンマ","区切りで複数のタグ付与が可能。
series_id 任意 - ひもづける連載のID。指定した連載に記事がひもづけられる。空文字の場合はどの連載にも追加しない。
topic_id 任意 - ひもづけるトピックのID。指定したトピックに記事がひもづけられる。空文字の場合はどのトピックにも追加しない。
creator_id 任意 - 記事の作成者。
updater_id 任意 - 記事の更新者。
author_ids 任意 - ひもづけるオーサーのID。空文字の場合はどのオーサーもひもづけない。

レスポンス

{
    "ok": true,
    "post": {
        "id": "0123456",
        "url": "https://nordot.app/0123456",
        "title": "桜の開花もカウントダウン",
        "subtitle": "今週末にも開花の予想",
        "status": "public",
        "body": " 本日**ウェザーリポート**が発表した最新の桜の開花予想によると、
        先週後半から全国的に気温の高い状態が続きつぼみの成長が一気に進んだため、西日本では今週末にも開花する所がちらほらと
        現れるでしょう。来週には関東地方も次第に春の陽気が訪れ、街
        ...
        ということもあり、全国的に次第に心地よい春の陽気を迎えるでしょう。",
        "source_url": "http://nordot-shimbun.com/posts/0123456",
        "published_at": "2015-12-10T20:09:31+00:00",
        "expired_at": "2016-11-10T20:09:31+00:00",
        "created_at": "2015-11-10T20:09:31+00:00",
        "updated_at": "2015-12-25T18:58:10+00:00",
        "images": [
            {
                "id": "2345678",
                "url": "https://img.nordot.jp/ch/images/2345678/origin_1.jpg",
                "thumb_360": "https://img.nordot.jp/t_thumb_360/ch/images/2345678/origin_1.jpg",
                "caption": "順番待ちの大きなつぼみたちも間もなく開花"
            },
            {
                "id": "3456789",
                "url": "https://img.nordot.jp/ch/images/3456789/origin_1.jpg",
                "thumb_360": "https://img.nordot.jp/t_thumb_360/ch/images/3456789/origin_1.jpg",
                "caption": "日本全国の開花予想日。北海道では4月末頃"
            }
        ],
        "labels": [
            {
                "name": "天気",
                "count": null
            }
        ],
        "tags": [
            "天気",
            "ウェザーリポート"
        ],
        "series": {
            "id": "5678901",
            "title": "桜の開花状況"
        },
        "topic": {
            "id": "6789012",
            "title": "桜特集2015"
        },
        "creator": {
            "id": "0012344",
            "email": "taro@nordot.jp",
            "name": "山田太郎",
            "job_title": "ライター",
            "about": "桜の開花を予想して30年。",
            "accepted_terms_ver": 1;,
            "created_at": "2015-11-16T19:08:41+00:00",
            "updated_at": "2018-02-06T20:10:52+00:00",
            "profile_image": {
              "url": "https://nordot-res.cloudinary.com/members/0012344/profile_1.png",
              "thumb_360": "https://nordot-res.cloudinary.com/t_thumb_360/members/0012344/profile_1.png"
          }
        },
        "updater": {
            "id": "0012344",
            "email": "taro@nordot.jp",
            "name": "山田太郎",
            "job_title": "ライター",
            "about": "桜の開花を予想して30年。",
            "accepted_terms_ver": 1;,
            "created_at": "2015-11-16T19:08:41+00:00",
            "updated_at": "2018-02-06T20:10:52+00:00",
            "profile_image": {
              "url": "https://nordot-res.cloudinary.com/members/0012344/profile_1.png",
              "thumb_360": "https://nordot-res.cloudinary.com/t_thumb_360/members/v/profile_1.png"
          }
        },
        "authors": [
            {
                "id": "0012344",
                "email": "taro@nordot.jp",
                "name": "山田太郎",
                "job_title": "ライター",
                "about": "桜の開花を予想して30年。",
                "accepted_terms_ver": 1;,
                "created_at": "2015-11-16T19:08:41+00:00",
                "updated_at": "2018-02-06T20:10:52+00:00",
                "profile_image": {
                    "url": "https://nordot-res.cloudinary.com/members/0012344/profile_1.png",
                    "thumb_360": "https://nordot-res.cloudinary.com/t_thumb_360/members/0012344/profile_1.png"
                }
            }
        ]
    }
}

作成されたデータを返します。詳細は、contentsholder postオブジェクトを参照してください。

エラー

エラーコード 説明
no_unit_id unit_idが必須なのに渡されていない
invalid_post_id 不正なpost_idの指定
post_not_found 記事が見つからない
no_update_param 更新するパラメータがひとつも渡されていない
invalid_title 不正なtitleの指定
invalid_subtitle 不正なsubtitleの指定
invalid_status 不正なstatusの指定
invalid_body 不正なbodyの指定
invalid_source_url 不正なsource_urlの指定
invalid_published_at 不正なpublished_atの指定
invalid_expired_at 不正なexpired_atの指定
invalid_label 不正なlabelの指定
invalid_series_id 不正なseries_idの指定
series_not_found 連載が見つからない
invalid_topic_id 不正なtopic_idの指定
topic_not_found トピックが見つからない
invalid_creator_id 不正なcreator_idの指定
invalid_author_ids 不正なauthor_idsの指定

上記以外のエラーは、共通エラーの項目を参照してください。