contentsholder/posts.create - Nordot for developers

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	任意	空文字	付与するラベル。カンマ "," 区切りで複数のラベル付与が可能。空文字の場合はラベルを付与しない。
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",
        "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月末頃"
            }
        ],
        "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/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の指定

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