跳转到主要内容
账户设置若要访问这些端点,你需要:请在我们的入门指南中了解如何获取 X API v2 端点的访问权限。
入门

认证

您可以使用 OAuth 1.0a 用户上下文、[OAuth 2.0 App-Only](https://developer.x.com(/resources/fundamentals/authentication#app-only-authentication-and-oauth-2-0-bearer-token)OAuth 2.0 授权码(PKCE) 来认证此端点。  

发起请求

你可以通过提供一个 ID 来调用 Communities Lookup 端点,如下所示(使用 ID 1758747817642700922):
      curl --location 'https://api.x.com/2/communities/1758747817642700922' --header 'Authorization: ••••••'
如果请求成功,您将看到如下所示的 JSON 响应:
{
    "data": {
        "access": "Public",
        "description": "欢迎来到动漫社区!动漫爱好者聚集在这里分享他们最喜欢的节目,讨论一切与动漫相关的内容。",
        "join_policy": "Open",
        "name": "动漫社区"
    }
}

社区字段

通过指定社区字段,您可以获取与某个社区关联的更多数据。 可用的社区字段如下:
字段值类型说明
created_at日期(ISO 8601)社区的创建时间。
id字符串社区的唯一标识符。
name字符串社区名称。
description字符串社区的描述文本(如有)。
access字符串社区的访问级别。

可能为:

* Public
* Closed
join_policy字符串社区的加入策略。

可能为:

* Open
* RestrictedJoinRequestsDisabled
* RestrictedJoinRequestsRequireAdminApproval
* RestrictedJoinRequestsRequireModeratorApproval
* SuperFollowRequired
member_count整数已加入该社区的成员数量。

示例请求

您可以像下面这样调用 Communities Lookup 端点,并包含额外的 community fields(使用 ID 1758747817642700922):
curl --location 'https://api.x.com/2/communities/1758747817642700922?community.fields=access,created_at,description,id,join_policy,member_count,name' --header 'Authorization: ••••••'
示例响应 如果请求成功,你将看到如下所示的 JSON 响应:
{
    "data": {
        "description": "欢迎来到动漫社区!动漫爱好者在这里聚集,分享他们最喜爱的作品,讨论一切与动漫相关的话题。",
        "access": "公开",
        "member_count": 40369,
        "created_at": "2024-02-17T06:58:50.000Z",
        "join_policy": "开放",
        "name": "动漫社区",
        "id": "Q29tbXVuaXR5OjE3NTg3NDc4MTc2NDI3MDA5MjI="
    }
}