Skip to main content

比较 X API 的 List 成员 endpoint

v2 的 List 成员 endpoint 组将取代 Standard v1.1 的 GET lists/membersGET lists/membershipsPOST lists/members/createPOST lists/members/destroy endpoint。如果你的代码、App 或工具使用了这些 List 成员 endpoint 的任一版本,且正考虑迁移到较新的 X API v2 endpoint,那么这组指南适合你。 

List 成员查询

v2 的 List 成员查询 endpoint 将取代标准的 GET lists/membersGET lists/memberships endpoint。 下表比较了 Standard v1.1 与 X API v2 的 List endpoint: List 成员查询
描述Standard v1.1X API v2
支持的 HTTP 方法GETGET
主机域名https://api.x.comhttps://api.x.com
endpoint 路径/1.1/lists/members.json/2/lists/:id/members
AuthenticationOAuth 1.0a 用户上下文

App only
OAuth 1.0a 用户上下文

OAuth 2.0 授权码模式(Authorization Code)配合 PKCE

App only
默认请求请求速率限制使用 OAuth 1.0a:每 15 分钟 900 次请求

使用 App only:每 15 分钟 75 次请求
使用 OAuth 1.0a:每 15 分钟 900 次请求

使用 OAuth 2.0:每 15 分钟 900 次请求

使用 App only:每 15 分钟 900 次请求
List 成员关系查询
描述Standard v1.1X API v2
支持的 HTTP 方法GETGET
主机域名https://api.x.comhttps://api.x.com
endpoint 路径/1.1/lists/memberships.json/2/users/:id/list_memberships
AuthenticationOAuth 1.0a 用户上下文

App only
OAuth 1.0a 用户上下文

OAuth 2.0 授权码模式(Authorization Code)配合 PKCE

App only
默认请求请求速率限制使用 OAuth 1.0a:每 15 分钟 75 次请求

使用 App only:每 15 分钟 75 次请求
使用 OAuth 1.0a:每 15 分钟 75 次请求

使用 OAuth 2.0:每 15 分钟 75 次请求

使用 App only:每 15 分钟 75 次请求

管理 List 成员

用于管理 List 成员的 v2 endpoint 将取代标准的 POST lists/members/createPOST lists/members/destroy endpoint。 下表对比了 Standard v1.1 与 X API v2 的 List endpoint: 添加成员
描述Standard v1.1X API v2
支持的 HTTP 方法POSTPOST
主机域名https://api.x.comhttps://api.x.com
endpoint 路径/1.1/lists/members/create.json/2/lists/:id/members
AuthenticationOAuth 1.0a 用户上下文OAuth 1.0a 用户上下文

OAuth 2.0 授权码模式(Authorization Code)配合 PKCE
默认请求请求速率限制每 15 分钟 300 次请求(每用户)
移除成员
描述Standard v1.1X API v2
支持的 HTTP 方法POSTDELETE
主机域名https://api.x.comhttps://api.x.com
endpoint 路径/1.1/lists/members/destroy.json/2/lists/:id/:user_id
AuthenticationOAuth 1.0a 用户上下文OAuth 1.0a 用户上下文

OAuth 2.0 授权码模式(Authorization Code)配合 PKCE
默认请求请求速率限制每 15 分钟 300 次请求(每用户)
要访问 X API v2 的 endpoint,您必须先注册开发者账户。进行认证时,必须使用位于某个 Project 内的开发者 App所提供的密钥和令牌。 在我们的入门页面了解更多关于获取 X API v2 endpoint 访问权限的信息。
I