跳转到主要内容将某个账户静音,可在不取消关注或不拉黑该账户的情况下,将其Post从你的时间线中隐藏。被静音的账户不会知道你已将其静音,你也可随时取消静音。借助“管理静音”端点,开发者可以为X上的用户打造更安全的体验。一个使用“管理静音”的示例是:应用允许你在指定时长内,将可能就特定主题发布Post的账户设为静音。通过“静音查询”端点,你可以查看你或某个已认证用户已静音的账户。这有助于判断你如何与这些被静音的账户互动。
由于使用“静音查询”会请求私有信息,且使用“管理静音”会代表用户发起请求,你必须使用OAuth 1.0a 用户上下文或OAuth 2.0 授权码(PKCE)对这些端点进行认证,并使用与已授权你应用的用户关联的用户访问令牌。该令牌可通过三方 OAuth 流程(OAuth 1.0a)或Authorization Code with PKCE 授权流程(OAuth 2.0)生成。
静音查询端点允许你查看经过身份验证的用户已静音的账户。该端点对每位用户的速率限制为每15分钟15次请求。
“管理静音”端点允许你以已认证用户的身份对指定账户进行静音或取消静音。针对这些端点,提供两种方法:POST 和 DELETE。POST 用于静音账户,DELETE 用于取消静音。POST 与 DELETE 端点的用户速率限制均为每 15 分钟 50 次请求。
**请注意:**如果用户在 X 上进行静音操作,每 15 分钟的限制为 200 次请求。
账户设置
要访问这些端点,你需要:
在我们的入门指南中了解如何获取 X API v2 端点的访问权限。