跳转到主要内容

列表成员查询

成员查询组提供两个端点。你可以获取指定列表的成员详情,并查看某个用户加入了哪些列表。这些端点可用于基于成员信息帮助人们策划和整理新的列表。 在查询成员详情时,速率上限为每 15 分钟 900 次请求;在查询用户的列表成员身份时,速率上限为每 15 分钟 75 次请求。 你可以使用 OAuth 1.0a 用户上下文仅应用OAuth 2.0 授权码(PKCE) 来为此端点的请求进行认证。   

管理 List 成员

管理 List 成员的端点允许你代表已认证的用户向某个 List 添加或移除成员。对于这些端点,有两种可用方法:POST 和 DELETE。POST 用于向 List 添加成员,DELETE 用于从 List 中移除成员。两者的用户速率限制均为每 15 分钟 300 次请求。 请注意,List 的成员数量不能超过 5,000。 由于你使用这些端点代表用户发起请求,必须通过 OAuth 1.0a 用户上下文OAuth 2.0 授权码(PKCE) 对其进行认证,并使用与已授权你应用的用户关联的用户访问令牌。你可以通过 三方 OAuth 流程(OAuth 1.0a)或 Authorization Code with PKCE 授权流(OAuth 2.0)生成这些令牌。
账户设置要访问这些端点,你需要:在我们的 入门指南 中了解有关获取 X API v2 端点访问权限的更多信息。