curator/curations.list
作成したキュレーションの一覧を取得
URL
GET /v1.0/curator/curations.list
パラメータ
名前 | 必須 | デフォルト値 | 説明 |
---|---|---|---|
unit_id | 必須 | - | キュレーター・ユニットのID |
tag_id | 任意 | 空文字 | タグによる絞り込み。作成したキュレーショ ンに付与したタグのIDを指定。空文字の場合は絞り込みをしない。 |
status | 任意 | 空文字 | キュレーションの公開状況による絞り込み。公開ならpublic、非公開ならdraftを指定。空文字の場合は絞り込みをしない。 |
published | 任意 | 空文字 | 公開日時を過ぎている記事のみ絞り込むならtrue。公開日時を過ぎていない記事のみ絞り込むならfalse。空文字の場合は絞り込みをしない。 |
offset | 任意 | 0 | 取得開始位置。0~5000の範囲で指定。 |
limit | 任意 | 10 | 取得件数。1~100の範囲で指定。 |
レスポンス
{
"ok": true,
"curations": [
{
"id": "0123456",
"annotation": "今週末は花見に繰り出してみてはいかがでしょうか?",
"status": "public",
"published_at": "2015-12-30T20:09:31+00:00",
"created_at": "2015-11-10T20:09:31+00:00",
"updated_at": "2015-12-25T18:58:10+00:00",
"content":{
"url": "https://nordot.app/0123456",
"url_curation": "https://nordot.app/0123456?c=0123456",
"title": "桜特集",
"site_name": "ノアドット新聞",
"description": "本日ウェザーリポートが発表した最新の桜の開花予想によると、
先週後半から全国的に気温の高い状態が続きつぼみの成長が一気に進んだため、
西日本では今週末にも開花する所が ちらほらと現れるでしょう。来週には関東...",
"image_url": "https://nordot-res.cloudinary.com/t_size_l/ch/images/0123456/origin_1.jpg",
"image_url_w": 342,
"image_url_h": 480,
"image_thumb_360": "https://nordot-res.cloudinary.com/t_thumb_360/ch/images/0123456/origin_1.jpg",
"image_caption": "今年の桜は少し早咲きのようです。",
"published_at": "2018-02-05T02:48:09+00:00",
"expired_at": "2018-03-07T02:48:09+00:00",
"deleted": false,
"tags": [
"天気",
"ウェザーリポート"
],
"unit":{
"id": "1234567",
"name": "ノアドット新聞 WEB",
"status": "public",
"signature_color": "1B62AA",
"header_type": "border",
"header_position": "center",
"copyright_owner": "株式会社ノアドット新聞",
"default_post_expire_days": 30,
"created_at": "2015-11-16T20:15:13+00:00",
"updated_at": "2018-02-04T08:48:34+00:00",
"header_image":{
"url": "https://nordot-res.cloudinary.com/ch/units/000111222/header_2.png",
"url_w": 300,
},
"profile_image":{
"url": "https://nordot-res.cloudinary.com/ch/units/000111222/profile_1.jpg",
"square_200": "https://nordot-res.cloudinary.com/t_square_200/ch/units/000111222/profile_1.jpg"
},
"publisher":{
"id": "111222333",
"name": "株式会社MANTAN",
"created_at": "2015-11-16T19:38:02+00:00",
},
"language": "",
"timezone": ""
}
},
"unit":{
"id": "000111222quot",
"name": "NDT",
"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/222333444/profile_6.png",
"thumb_360": "https://nordot-res.cloudinary.com/t_thumb_360/cu/units/222333444/profile_6.png"
},
"follow":{
"twitter_url": "",
"facebook_page_url": ""
},
"connection":{
"facebook": false,
"twitter": false
},
"publisher":{
"id": "222333444",
"name": "ノアドット株式会社",
"created_at": "2015-11-16T19:02:38+00:00",
},
"language": "en-US",
"timezone": "America/Indiana/Indianapolis",
"website_urls":["https://www.222333444.jp/"],
"facebook_url": "https://www.facebook.com/222333444",
"twitter_url": "https://twitter.com/222333444",
"instagram_url": "https://instagram.com/222333444"
},
},
...
],
"paging": {
"count": 10,
"offset": 0,
"limit": 10,
"has_next": true
}
}
curationsには、条件に一致したcurator curationオブジェクトの配列が入っています。詳細は、curator curationオブジェクトとpagingオブジェクトを参照してください。
エラー
エラーコード | 説明 |
---|---|
no_unit_id | unit_idが必須なのに渡されていない |
invalid_unit_id | 不正なunit_idの指定 |
unit_not_found | ユニットが見つからない |
invalid_tag_id | 不正なtag_idの指定 |
tag_not_found | タグが見つからない |
invalid_status | 不正なstatusの指定 |
invalid_published_at | 不正なpublished_atの指定 |
invalid_offset | 不正なoffsetの指定 |
invalid_limit | 不正なlimitの指定 |