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": "https://nordot.app/0123456",
"url_curation": "https://nordot.app/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,
"tags": [
"天気",
"ウェザーリポート"
],
"unit": null
},
"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 | タグが見つからない |
上記以外のエラーは、共通エラーの項目を参照してください。