curator/curations.create

キュレーションを作成

URL

POST /v1.0/curator/curations.create

パラメータ

名前 必須 デフォルト値 説明
unit_id 必須 - キュレーター・ユニットのID
content_url 必須 空文字 キュレートするコンテンツのURL
annotation 任意 空文字 アノテーション(キュレートするコンテンツに対するキュレーターとしての感想、見解、 視点)
status 任意 draft 公開・非公開の設定。公開するならpublic、非公開にしておくならdraftを指定。
published_at 任意 現在の日時 公開日時。値が現在より過去の日時なら、その日時で即公開。値が未来の日時なら、その日時での公開予約。
tag_ids 任意 空文字 付与するタグのID。カンマ "," 区切りで複数 のタグ付与が可能。空文字の場合はタグを付与しない。

レスポンス

{
            "ok": true,
            "curation":{
                "id": "0123456",
                "annotation": "桜を楽しもう!",
                "status": "draft",
                "published_at": "2018-03-05T02:51:20+00:00",
                "created_at": "2018-03-05T02:51:21+00:00",
                "updated_at": "2018-03-05T02:51:21+00:00",
                "content":{
                "url": "http://this.kiji.is/0123456",
                "url_curation": "http://this.kiji.is/0123456",
                "title": "this.kiji.is",
                "site_name": "",
                "description": "",
                "image_url": "",
                "image_url_w": 0,
                "image_url_h": 0,
                "image_thumb_360": "",
                "image_caption": "",
                "published_at": "",
                "expired_at": "",
                "deleted": false,
                "unit": null
            },
            "tags":[
                {
                    "id": "1122333",
                    "name": "桜",
                    "created_at": "2016-04-27T05:10:35+00:00",
                    "updated_at": "2016-04-27T05:10:35+00:00"
                }
            ],
            "unit":{
                "id": "0001234",
                "name": "NST",
                "path": "ndt",
                "status": "public",
                "signature_color": "FFD900",
                "header_type": "border",
                "header_position": "left",
                "profile_name": "ndt!",
                "introduction": "興味のあることだけを、気が向いたタイミングで。",
                "created_at": "2015-11-17T11:13:45+00:00",
                "updated_at": "2018-02-28T14:42:24+00:00",
                "header_image": null,
                "profile_image":{
                "url": "https://nordot-res.cloudinary.com/cu/units/0001234/profile_6.png",
                "thumb_360": "https://nordot-res.cloudinary.com/t_thumb_360/cu/units/0001234/profile_6.png"
            },
            "follow":{
              "twitter_url": "",
              "facebook_page_url": ""
            },
            "connection":{
              "facebook": false,
              "twitter": false
            },
            "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": "America/Indiana/Indianapolis",
              "website_urls":["https://www.0012345.jp/"],
              "facebook_url": "https://www.facebook.com/0012345",
              "twitter_url": "https://twitter.com/0012345",
              "instagram_url": "https://instagram.com/0012345"
            }
        }
    }
}

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

エラー

エラーコード 説明
no_unit_id unit_idが必須なのに渡されていない
invalid_unit_id 不正なunit_idの指定
unit_not_found ユニットが見つからない
no_content_url content_urlが必須なのに渡されていない
invalid_content_url 不正なcontent_urlの指定
already_posted_content_url このcontent_urlを投稿したキュレーションが既に存在する
invalid_annotation 不正なannotationの指定
invalid_status 不正なstatusの指定
invalid_published_at 不正なpublished_atの指定
invalid_tag_id 不正なtag_idの指定
tag_not_found タグが見つからない

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