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://this.kiji.is/0123456",
                "url_curation": "https://this.kiji.is/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,
                "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": ""
                }
            },
            "tags":[
                {
                    "id": "0123456",
                    "name": "新聞",
                    "created_at": "2016-04-18T06:16:19+00:00",
                    "updated_at": "2016-04-18T06:16:19+00:00"
                }
            ],
            "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の指定