contentsholder/posts.create

記事を作成

URL

POST /v1.0/contentsholder/posts.create

パラメータ

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

レスポンス

{
    "ok": true,
    "post": {
        "id": "0123456",
        "url": "https://this.kiji.is/0123456",
        "title": "桜の開花もカウントダウン",
        "subtitle": "今週末にも開花の予想",
        "status": "public",
        "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",
        "cover_image": null,
        "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月末頃"
            }
        ],
        "tags":[],
        "labels": [
            {
                "name": "天気",
                "count": null
            }
        ],
        "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/0012344/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"
                }
            }
        ],
        "unit":{
            "id": "1234567",
            "name": "ノアドット新聞",
            "status": "public",
            "signature_color": "0f0f0f",
            "header_type": "background",
            "header_position": "center",
            "copyright_owner": "株式会社ノアドット新聞",
            "default_post_expire_days": 0,
            "created_at": "2015-11-16T19:06:46+00:00",
            "updated_at": "2018-03-05T05:45:25+00:00",
            "header_image":{
            "url": "https://nordot-res.cloudinary.com/ch/units/1234567/header_69.png",
            "url_w": 400,
            "url_h": 60,
            "thumb_360": "https://nordot-res.cloudinary.com/t_thumb_360/ch/units/1234567/header_69.png",
            "square_300": "https://nordot-res.cloudinary.com/t_square_300/ch/units/1234567/header_69.png"
            },
            "profile_image": null,
            "publisher":{
                "id": "0012345",
                "name": "株式会社ノアドット新聞",
                "created_at": "2015-11-16T19:02:38+00:00",
                "updated_at": "2018-02-06T17:29:41+00:00"
            },
            "language": "en-US",
            "timezone": "Asia/Tokyo"
        },
        "body": " 本日**ウェザーリポート**が発表した最新の桜の開花予想による
        と、先週後半から全国的に気温の高い状態が続きつぼみの成長が一気に進んだため、西日本では今週末に
        も開花する所がちらほらと現れるでしょう。来週には関東地方も次第に春の陽気が訪れ、
        ...
        ということもあり、全国的に次第に心地よい春の陽気を迎えるでしょう。"
        ...
    }
}

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

エラー

エラーコード 説明
no_unit_id unit_idが必須なのに渡されていない
invalid_unit_id 不正なunit_idの指定
unit_not_found ユニットが見つからない
no_title titleが必須なのに渡されていない
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の指定

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