タグ

タグ

タグ検索

GET /api/v1/tags HTTP/1.1
Copy

Request

パラメータ 内容 必須 デフォルト値 最大値
page ページ 1
per_page ページ毎の取得数 20 100
{
  "page": 1,
  "per_page": 50
}
Copy

Response

HTTP/1.1 200 OK
{
  "tags": [
    {
      "name": "タグA",
      "page_count": 10,
    },
    {
      "name": "タグB",
      "page_count": 11,
    },
    {
      "name": "タグC",
      "page_count": 12,
    }
  ],
  "meta": {
    "previous_page": null,
    "next_page": "https://projectmode.notepm.jp/api/v1/tags?page=2&per_page=50",
    "page": 1,
    "per_page": 50,
    "total": 100
  }
}
Copy

タグ作成

POST /api/v1/tags HTTP/1.1
Copy

Request

パラメータ 内容 必須 デフォルト値 最大値
name タグ名 30文字
{
  "name": "タグA",
}
Copy

Response

HTTP/1.1 201 Created
{
  "tag": [
    {
      "name": "タグA",
    }
  ],
  "meta": {}
}
Copy

タグ削除

DELETE /api/v1/tags HTTP/1.1
Copy

Request

パラメータ 内容 必須 デフォルト値 最大値
name タグ名 30文字
{
  "name": "タグA",
}
Copy

Response

HTTP/1.1 204 No Content
Copy