Introduction

Configuration du compte

Pour accéder à ces endpoints, vous aurez besoin :

• D’un compte développeur approuvé.
• De vous authentifier à l’aide des clés et jetons d’une App développeur située au sein d’un Project. 

Pour en savoir plus sur l’accès aux endpoints de la X API v2, consultez notre guide de démarrage.

Premiers pas

​

Authentification

Vous pouvez authentifier ce endpoint avec Contexte utilisateur OAuth 1.0a, [OAuth 2.0 App-Only](https://developer.x.com(/resources/fundamentals/authentication#app-only-authentication-and-oauth-2-0-bearer-token), ou OAuth 2.0 Autorisation par code avec PKCE.  

​

Effectuer une requête

Vous pouvez appeler l’endpoint Communities Lookup en fournissant un id comme indiqué ci‑dessous (en utilisant l’id 1758747817642700922) :

      curl --location 'https://api.x.com/2/communities/1758747817642700922' --header 'Authorization: ••••••'

Si la requête aboutit, vous devriez voir la réponse JSON comme ci-dessous :

{
    "data": {
        "access": "Public",
        "description": "Bienvenue dans la Communauté Anime ! Un lieu où les fans d'anime se retrouvent pour partager leurs séries préférées et discuter de tout ce qui touche à l'anime.",
        "join_policy": "Ouvert",
        "name": "Communauté Anime"
    }
}

​

Champs de communauté

Vous pouvez récupérer des données supplémentaires associées à une communauté en spécifiant les Community Fields.

Les Community Fields suivants sont disponibles :

Valeur du champ	Type	Description
created_at	date (ISO 8601)	Date et heure de création de la communauté.
id	string	L’identifiant unique de la communauté.
name	string	Le nom de la communauté.
description	string	Le texte de la description de la communauté, le cas échéant.
access	string	Le niveau d’accès de la communauté. Peut être l’un des suivants : * Public * Closed
join_policy	string	La règle d’adhésion de la communauté. Peut être l’un des suivants : * Open * RestrictedJoinRequestsDisabled * RestrictedJoinRequestsRequireAdminApproval * RestrictedJoinRequestsRequireModeratorApproval * SuperFollowRequired
member_count	integer	Nombre de membres ayant rejoint la communauté.

​

Exemple de requête

Vous pouvez appeler l’endpoint Communities Lookup avec des community fields supplémentaires comme indiqué ci-dessous (en utilisant l’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: ••••••'

Exemple de réponse

Si la requête aboutit, vous devriez voir la réponse JSON comme ci-dessous :

{
    "data": {
        "description": "Bienvenue dans la Communauté Anime ! Ici, les fans d'anime se rassemblent pour partager leurs séries préférées et discuter de tout ce qui touche à l'anime.",
        "access": "Public",
        "member_count": 40369,
        "created_at": "2024-02-17T06:58:50.000Z",
        "join_policy": "Ouverte",
        "name": "Communauté Anime",
        "id": "Q29tbXVuaXR5OjE3NTg3NDc4MTc2NDI3MDA5MjI="
    }
}