Introduzione

Configurazione dell’account

Per accedere a questi endpoint, ti serviranno:

• Un account sviluppatore approvato.
• L’autenticazione utilizzando le chiavi e i token di un’App sviluppatore che si trova all’interno di un Project.

Scopri di più su come ottenere l’accesso agli endpoint della X API v2 nella nostra guida introduttiva.

Guida introduttiva

​

Autenticazione

Puoi autenticare questo endpoint usando Contesto utente OAuth 1.0a, OAuth 2.0 App-Only o OAuth 2.0 Authorization Code con PKCE.  

​

Effettuare una richiesta

Puoi chiamare l’endpoint Communities Lookup fornendo un id come mostrato di seguito (utilizzando l’id 1758747817642700922):

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

Se la richiesta va a buon fine, vedrai la risposta JSON come mostrato di seguito:

{
    "data": {
        "access": "Pubblico",
        "description": "Benvenuti nella Community Anime! Qui i fan degli anime si riuniscono per condividere le loro serie preferite e discutere di tutto ciò che riguarda gli anime.",
        "join_policy": "Aperto",
        "name": "Community Anime"
    }
}

​

Campi della Community

Puoi recuperare dati aggiuntivi associati a una Community specificando i Community Fields.

Sono disponibili i seguenti Community Fields:

Valore del campo	Tipo	Descrizione
created_at	date (ISO 8601)	Data e ora di creazione della Community.
id	string	L’identificatore univoco della Community.
name	string	Il nome della Community.
description	string	Il testo della descrizione della Community, se presente.
access	string	Il livello di accesso della Community. Può essere uno tra: * Public * Closed
join_policy	string	La policy di adesione della Community. Può essere una tra: * Open * RestrictedJoinRequestsDisabled * RestrictedJoinRequestsRequireAdminApproval * RestrictedJoinRequestsRequireModeratorApproval * SuperFollowRequired
member_count	integer	Il numero di membri che hanno aderito alla Community.

​

Esempio di richiesta

Puoi chiamare l’endpoint Communities Lookup con campi aggiuntivi della community, come mostrato di seguito (utilizzando 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: ••••••'

Esempio di risposta

Se la richiesta va a buon fine, vedrai la risposta JSON come mostrato di seguito:

{
    "data": {
        "description": "Benvenuti nella Comunità Anime! Qui i fan degli anime si riuniscono per condividere le loro serie preferite e discutere tutto ciò che riguarda gli anime.",
        "access": "Pubblico",
        "member_count": 40369,
        "created_at": "2024-02-17T06:58:50.000Z",
        "join_policy": "Aperta",
        "name": "Comunità Anime",
        "id": "Q29tbXVuaXR5OjE3NTg3NDc4MTc2NDI3MDA5MjI="
    }
}