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の指定 |
上記以外のエラーは、共通エラーの項目を参照してください。