contentsholder/posts.create

Creates a Story in your Content Owner Media Unit

URL

POST /v1.0/contentsholder/posts.create

Parameters

Argument Required Default Value Example Description
unit_id Required - 12345678912345 ID of your Content Owner Media Unit
title Required - Counting down to Sakura Blooming. Title
subtitle Optional Null Blooming forecasted this weekend. Subtitle (sub-heading).
status Optional draft Draft Describes a Story’s status i.e. when it is set to “draft” the Story is private, when it is set to “public”, the Story is published.
body Optional Null Loremipsum dolor sit amet. Main text of the Story. Maximum length is 30,000 characters. For more information about the text markup, please refer to the “Markdown Reference” document.
source_url Optional Null https://example.com/12345 URL of the Story (original site).
published_at Optional Current date and time 2018-05-11T20:09:31+00:00 Describes the Story’s published date and time. Set the timestamp to a previous date to publish the Story immediately. To publish the Story at an impending date, set the timestamp to a future date.
expired_at Optional Default expiry date and time "2019-05-01T20:09:31+00:00 Describes the Story’s expiry date and time. The default expiry date is set to the date specified in default_post_expire_days in the CMS from the published date. Set the value to Null to disregard the expiry date.
labels Optional Null Weather Specifies the label(s) a Story should contain. Use a comma to separate the labels in your list. If the value for the argument is null, label(s) will be omitted.
tags Optional Null weather Specifies the tag(s) a Story should contain. Usea comma to separate the tags in your list.
series_id Optional Null 5678901 Specifies the ID of the series associated with a Story. If the argument’s value is null, series will be omitted.
topic_id Optional Null 56794038 Specifies the ID of the topic associated with a Story. If the argument’s value is null, topic will be omitted.

Responses

{
    "ok": true,
    "post": {
        "id": "0123456",
        "url": "https://nordot.app/0123456",
        "title": "Counting down to sakura blooming",
        "subtitle": "Blooming forecasted this weekend",
        "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": "Big buds waiting to arrive will soon bloom"
            },
            {
                "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": "Estimated flowering date throughout Japan. In Hokkaido around the end of April"
            }
        ],
        "labels": [
            {
                "name": "weather",
                "count": null
            }
        ],
        "tags": [
            "weather",
            "weatherreport"
        ],
        "series": {
            "id": "5678901",
            "title": "Counting down to sakura blooming"
        },
        "topic": {
            "id": "6789012",
            "title": "sakura 2015"
        },
        "creator": {
            "id": "0012344",
            "email": "taro@nordot.jp",
            "name": "yamada",
            "job_title": "writer",
            "about": "Predicting cherry blossoms for 30 years",
            "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": "taro",
            "job_title": "writer",
            "about": "Predicting cherry blossoms for 30 years",
            "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": "taro",
                "job_title": "writer",
                "about": "Predicting cherry blossoms for 30 years",
                "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": "Nordot Post",
            "status": "public",
            "signature_color": "0f0f0f",
            "header_type": "background",
            "header_position": "center",
            "copyright_owner": "Nordot Inc.",
            "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": "Nordot Inc.",
                "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": " Today ** Based on the latest cherry blossom forecasting announced by Weather Report **
        , Since the late last week the high temperature condition continued nationwide from the latter half of the week,
         the growth of buds advanced at a stretch, so in western Japan this weekend
        There will be places where flowering will occur as well.
        In the next week Kanto region gradually comes to visit the spring weather,
        ...
        In other words, it will gradually have a pleasant spring season in nationwide."
        ...
    }
}

If successful, the method returns generated data. For more details, please refer to the “contentsholder post” objects.

Errors

Error Code Description
no_unit_id Value for "unit_id" is not specified.
invalid_unit_id Value passed for “unit_id" is invalid.
unit_not_found The Media Unit cannot be found.
no_title Value for “title” is not specified.
invalid_title Value passed for “title” is invalid.
invalid_subtitle Value passed for “subtitle” is invalid.
invalid_status Value passed for “status" is invalid.
invalid_body Value passed for “body" is invalid.
invalid_source_url Value passed for “source_url” is invalid.
invalid_published_at Value passed for “published_at” is invalid.
invalid_expired_at Value passed for “expired_at” is invalid.
invalid_label Value passed for “label” is invalid.
invalid_series_id Value passed for “series_id" is invalid.
series_not_found The series cannot be found.
invalid_topic_id Value passed for “topic_id" is invalid.
topic_not_found The topic cannot be found.
invalid_creator_id Value passed for “creator_id" is invalid.
invalid_author_ids Value passed for “author_ids" is invalid.

For other error codes, refer to the Common Errors section of this document.