tags API 方法
查看关于话题标签的信息或关注/取消关注话题标签。
查看单个话题标签的信息
GET /api/v1/tags/:id HTTP/1.1
显示一个话题标签及其相关信息
返回： Tag
OAuth： 公开访问，或要求用户令牌
版本历史：
4.0.0 - 添加
请求
路径参数
- :id
- 必需 字符串。话题标签的名称。
标头
- Authorization
- 提供此标头并附带
Bearer <user_token>以获得对此 API 方法的访问授权。
响应
200: OK
{
"name": "Test",
"url": "http://mastodon.example/tags/test",
"history": [
{
"day": "1668556800",
"accounts": "0",
"uses": "0"
},
{
"day": "1668470400",
"accounts": "0",
"uses": "0"
},
{
"day": "1668384000",
"accounts": "0",
"uses": "0"
},
{
"day": "1668297600",
"accounts": "1",
"uses": "1"
},
{
"day": "1668211200",
"accounts": "0",
"uses": "0"
},
{
"day": "1668124800",
"accounts": "0",
"uses": "0"
},
{
"day": "1668038400",
"accounts": "0",
"uses": "0"
}
],
"following": false
}
关注一个话题标签
POST /api/v1/tags/:id/follow HTTP/1.1
关注一个话题标签。包含已关注话题标签的嘟文将被插入到你的主页时间线中。
返回： Tag
OAuth： 用户令牌 + write:follows
版本历史：
4.0.0 - 添加
4.1.0 - 此操作现在是幂等的
请求
路径参数
- :id
- 必需 字符串。话题标签的名称。
标头
- Authorization
- 必需 提供此标头并附带
Bearer <user_token>以获得对此 API 方法的访问授权。
响应
200: OK
已成功关注该话题标签
{
"name": "Test",
"url": "http://mastodon.example/tags/test",
"history": [
{
"day": "1668556800",
"accounts": "0",
"uses": "0"
},
{
"day": "1668470400",
"accounts": "0",
"uses": "0"
},
{
"day": "1668384000",
"accounts": "0",
"uses": "0"
},
{
"day": "1668297600",
"accounts": "1",
"uses": "1"
},
{
"day": "1668211200",
"accounts": "0",
"uses": "0"
},
{
"day": "1668124800",
"accounts": "0",
"uses": "0"
},
{
"day": "1668038400",
"accounts": "0",
"uses": "0"
}
],
"following": true
}
401: Unauthorized
Authorization 标头缺失或无效。
{
"error": "The access token is invalid"
}
422: Unprocessable entity
在 4.1.0 之前：该话题标签已被关注
{
"error": "Duplicate record"
}
取消关注一个话题标签
POST /api/v1/tags/:id/unfollow HTTP/1.1
取消关注一个话题标签。包含此话题标签的嘟文将不再被插入到你的主页时间线中。
返回： Tag
OAuth： 用户令牌 + write:follows
版本历史：
4.0.0 - 添加
请求
路径参数
- :id
- 必需 字符串。话题标签的名称。
标头
- Authorization
- 必需 提供此标头并附带
Bearer <user_token>以获得对此 API 方法的访问授权。
响应
200: OK
已成功取消关注该话题标签，或原本就未关注该话题标签
{
"name": "Test",
"url": "http://mastodon.example/tags/test",
"history": [
{
"day": "1668556800",
"accounts": "0",
"uses": "0"
},
{
"day": "1668470400",
"accounts": "0",
"uses": "0"
},
{
"day": "1668384000",
"accounts": "0",
"uses": "0"
},
{
"day": "1668297600",
"accounts": "1",
"uses": "1"
},
{
"day": "1668211200",
"accounts": "0",
"uses": "0"
},
{
"day": "1668124800",
"accounts": "0",
"uses": "0"
},
{
"day": "1668038400",
"accounts": "0",
"uses": "0"
}
],
"following": false
}
401: Unauthorized
Authorization 标头缺失或无效。
{
"error": "The access token is invalid"
}
另请参考
GET /api/v1/followed_tags app/controllers/api/v1/tags_controller.rb翻译状态： 本文是英文页面 tags API methods 的翻译，最后翻译时间：2025-04-21，点击这里可以查看翻译后页面的改动。