featured_tags

よく使うタグの登録

get
View your featured tags

https://mastodon.example/api/v1/featured_tags

**戻り値:**FeaturedTagの配列
OAuth: User token + read:accounts
実装履歴:

  • 3.0.0 - 追加されました

リクエスト

ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success 

[
  {
    "id": "627",
    "name": "nowplaying",
    "statuses_count": 36,
    "last_status_at": "2019-11-15T07:14:43.524Z"
  }
]

401: Unauthorized

Invalid or missing Authorization header 

{
  "error": "The access token is invalid"
}

post
Feature a tag

https://mastodon.example/api/v1/featured_tags

戻り値: FeaturedTag
OAuth: User token + write:accounts
実装履歴:

  • 3.0.0 - 追加されました

リクエスト

ヘッダ
Authorization
必須
string
Bearer <user token>
フォームのパラメータ
name
必須
string
The hashtag to be featured.

レスポンス

200: Success

FeaturedTagはある特定のnameを付けて作成されます。 

{
  "id": "13174",
  "name": "circasurvive",
  "statuses_count": 11,
  "last_status_at": "2019-11-15T06:20:32.769Z"
}

422: Unprocessable Entity

nameが有効なハッシュタグで無い場合、例えば許可されていない文字や数字だけの場合 

{
  "error": "Validation failed: Tag is invalid"
}

delete
Unfeature a tag

https://mastodon.example/api/v1/featured_tags/:id

戻り値: 空のオブジェクト
OAuth: User token + write:accounts
実装履歴:

  • 3.0.0 - 追加されました

リクエスト

パス
:id
必須
string
The id of the FeaturedTag to be unfeatured.
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

An empty object will be returned if the featured tag was successfully deleted. 

{}

404: Not Found

If the ID does not exist or is not owned by you 

{
  "error": "Record not found"
}

get
Suggested tags to feature

https://mastodon.example/api/v1/featured_tags/suggestions

Shows your 10 most-used tags, with usage history for the past week.

戻り値: Array of Tag with History
OAuth: User token + read:accounts
実装履歴:

  • 3.0.0 - 追加されました

リクエスト

ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

Truncated results to first and last tag. 

[
  {
    "name": "nowplaying",
    "url": "https://mastodon.social/tags/nowplaying",
    "history": [
      {
        "day": "1574553600",
        "uses": "200",
        "accounts": "31"
      },
      {
        "day": "1574467200",
        "uses": "272",
        "accounts": "39"
      },
      {
        "day": "1574380800",
        "uses": "345",
        "accounts": "40"
      },
      {
        "day": "1574294400",
        "uses": "366",
        "accounts": "46"
      },
      {
        "day": "1574208000",
        "uses": "226",
        "accounts": "32"
      },
      {
        "day": "1574121600",
        "uses": "217",
        "accounts": "42"
      },
      {
        "day": "1574035200",
        "uses": "214",
        "accounts": "34"
      }
    ]
  },
  ...
  {
    "name": "mastothemes",
    "url": "https://mastodon.social/tags/mastothemes",
    "history": [
      {
        "day": "1574553600",
        "uses": "0",
        "accounts": "0"
      },
      {
        "day": "1574467200",
        "uses": "0",
        "accounts": "0"
      },
      {
        "day": "1574380800",
        "uses": "0",
        "accounts": "0"
      },
      {
        "day": "1574294400",
        "uses": "0",
        "accounts": "0"
      },
      {
        "day": "1574208000",
        "uses": "0",
        "accounts": "0"
      },
      {
        "day": "1574121600",
        "uses": "0",
        "accounts": "0"
      },
      {
        "day": "1574035200",
        "uses": "0",
        "accounts": "0"
      }
    ]
  }
]

401: Unauthorized 

{
  "error": "The access token is invalid"
}

最終更新 July 1, 2020 · このページを改善する
他の言語: English