admin/trends API 方法
TODO
查看热门链接
GET /api/v1/admin/trends/links HTTP/1.1
比其他链接分享更多的链接，包括未批准和未审核的链接。
返回: Trends::Link 数组
OAuth: 用户令牌 + admin:read
权限: 管理分类
版本历史:
3.5.0 - 添加
请求
标头
- Authorization
- 必需 提供此标头，其中包含
Bearer <user_token>，以获得对此 API 方法的访问授权。
响应
200: OK
[
{
"url": "https://twitter.com/arufa_faru/status/1594262272007753728",
"title": "ARuFa on Twitter",
"description": "“言葉をマネするぬいぐるみを改造してエレキギターを直接繋いでみました”",
"type": "link",
"author_name": "",
"author_url": "",
"provider_name": "Twitter",
"provider_url": "",
"html": "",
"width": 400,
"height": 225,
"image": "https://media.chitter.xyz/cache/preview_cards/images/002/162/720/original/b5360261e8ce17fc.jpeg",
"embed_url": "",
"blurhash": "UNFiDM~o-oD%x[xtaxM|xaNHRkjsoft7ofWB",
"history": [
{
"day": "1669507200",
"accounts": "9",
"uses": "9"
},
{
"day": "1669420800",
"accounts": "0",
"uses": "0"
},
{
"day": "1669334400",
"accounts": "0",
"uses": "0"
},
{
"day": "1669248000",
"accounts": "0",
"uses": "0"
},
{
"day": "1669161600",
"accounts": "0",
"uses": "0"
},
{
"day": "1669075200",
"accounts": "0",
"uses": "0"
},
{
"day": "1668988800",
"accounts": "0",
"uses": "0"
}
]
},
// ...
]
403: Forbidden
授权用户缺少权限，或 Authorization 标头无效或缺失
{
"error": "This action is not allowed"
}
查看热门嘟文
GET /api/v1/admin/trends/statuses HTTP/1.1
比其他嘟文互动更多的嘟文，包括未批准和未审核的嘟文。
返回: Status 数组
OAuth: 用户令牌 + admin:read
权限: 管理分类
版本历史:
3.5.0 - 添加
请求
标头
- Authorization
- 必需 提供此标头，其中包含
Bearer <user_token>，以获得对此 API 方法的访问授权。
响应
200: OK
[
{
"id": "109415512969053017",
"created_at": "2022-11-27T11:23:52.000Z",
"in_reply_to_id": null,
"in_reply_to_account_id": null,
// ...
"account": {
"id": "109332240210946752",
// ...
},
"media_attachments": [],
"mentions": [],
"tags": [],
"emojis": [],
"card": null,
"poll": null
},
// ...
]
403: Forbidden
授权用户缺少权限，或 Authorization 标头无效或缺失
{
"error": "This action is not allowed"
}
查看热门话题标签
GET /api/v1/admin/trends/tags HTTP/1.1
过去一周内使用频率更高的话题标签，包括未批准和未审核的话题标签。
返回: Admin::Tag 数组
OAuth: 用户令牌 + admin:read
权限: 管理分类
版本历史:
3.5.0 - 添加
4.0.0 - 由于错误，返回 Tag 数组
4.1.0 - 修复错误
请求
标头
- Authorization
- 必需 提供此标头，其中包含
Bearer <user_token>，以获得对此 API 方法的访问授权。
响应
200: OK
[
{
"name": "caturday",
"url": "https://mastodon.example/tags/caturday",
"history": [
{
"day": "1669507200",
"accounts": "53",
"uses": "56"
},
{
"day": "1669420800",
"accounts": "142",
"uses": "171"
},
{
"day": "1669334400",
"accounts": "11",
"uses": "11"
},
{
"day": "1669248000",
"accounts": "8",
"uses": "9"
},
{
"day": "1669161600",
"accounts": "8",
"uses": "20"
},
{
"day": "1669075200",
"accounts": "11",
"uses": "11"
},
{
"day": "1668988800",
"accounts": "17",
"uses": "22"
}
],
"id": "802",
"trendable": true,
"usable": true,
"requires_review": false
},
]
403: Forbidden
授权用户缺少权限，或 Authorization 标头无效或缺失
{
"error": "This action is not allowed"
}
另请参考
app/controllers/api/v1/admin/trends/links_controller.rb app/controllers/api/v1/admin/trends/statuses_controller.rb app/controllers/api/v1/admin/trends/tags_controller.rb翻译状态： 本文是英文页面 trends API methods 的翻译，最后翻译时间：2025-04-21，点击这里可以查看翻译后页面的改动。