curator/tags.list

作成したタグの一覧を取得

URL

GET /v1.0/curator/tags.list

パラメータ

名前 必須 デフォルト値 説明
unit_id 必須 - キュレーター・ユニットのID
offset 任意 0 取得開始位置。0~5000の範囲で指定。
limit 任意 10 取得件数。1~100の範囲で指定。

レスポンス

{
    "ok": true,
    "tags": [
        {
            "id": "9012345",
            "name": "花見",
            "created_at": "2015-11-10T20:09:31+00:00",
            "updated_at": "2015-12-25T18:58:10+00:00"
        },
        ...
    ],
    "paging": {
        "count": 10,
        "offset": 0,
        "limit": 10,
        "has_next": true
    }
}

tagsには、条件に一致したcurator tagオブジェクトの配列が入っています。詳細は、curator tag オブジェクトとpagingオブジェクトを参照してください。

エラー

エラーコード 説明
no_unit_id unit_idが必須なのに渡されていない
invalid_unit_id 不正なunit_idの指定
unit_not_found ユニットが見つからない
invalid_offset 不正なoffsetの指定
invalid_limit 不正なlimitの指定

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