directory API 方法
你的网站所知的用户目录。
查看用户目录
GET /api/v1/directory HTTP/1.1
列出目录中可见的用户。
返回： Account数组
OAuth： 公开
版本历史：
3.0.0 - 添加
请求
查询参数
- offset
- 数字。跳过前 n 个结果。
- limit
- 数字。加载多少个用户。默认为 40 个用户。最多 80 个用户。
- order
- 字符串。使用
active按最近发布的嘟文排序（默认），或者使用new按用户的创建时间降序排序。 - local
- 布尔值。若为 true，则仅返回本站帐户。
响应
200: OK
limit=2 的示例结果
[
{
"id": "796927",
"username": "eternalNo3",
"acct": "eternalNo3@best-friends.chat",
"display_name": "ESD＠┓（谷）┏",
// ...
},
{
"id": "787648",
"username": "ariel",
"acct": "ariel@best-friends.chat",
"display_name": "あやっしー🧜🏻♀️",
// ...
}
]
另请参考
app/controllers/api/v1/directories_controller.rb翻译状态： 本文是英文页面 directory API methods 的翻译，最后翻译时间：2025-04-21，点击这里可以查看翻译后页面的改动。