Einführung

Kontoeinrichtung

Um auf diese Endpoints zuzugreifen, benötigen Sie:

• Ein genehmigtes Developer-Konto.
• Eine Authentifizierung mit den Keys und Tokens aus einer Developer-App, die sich innerhalb eines Project befindet. 

Erfahren Sie mehr über den Zugriff auf die X API v2 Endpoints in unserem Einführungsleitfaden.

Erste Schritte

​

Authentifizierung

Sie können dieses endpoint entweder mit OAuth 1.0a User Context, [OAuth 2.0 App-Only](https://developer.x.com(/resources/fundamentals/authentication#app-only-authentication-and-oauth-2-0-bearer-token), oder OAuth 2.0 Authorization Code mit PKCE authentifizieren.  

​

Eine Anfrage senden

Sie können das Communities Lookup endpoint aufrufen, indem Sie eine id angeben, wie unten gezeigt (mit der id 1758747817642700922):

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

Wenn die Anfrage erfolgreich ist, sehen Sie die JSON-Antwort wie unten dargestellt:

{
    "data": {
        "access": "Öffentlich",
        "description": "Willkommen in der Anime-Community! Hier treffen sich Anime-Fans, um ihre Lieblings-Serien zu teilen und über alles rund um Anime zu diskutieren.",
        "join_policy": "Offen",
        "name": "Anime-Community"
    }
}

​

Community-Felder

Sie können zusätzliche data abrufen, die mit einer Community verknüpft sind, indem Sie Community-Felder angeben.

Die folgenden Community-Felder sind verfügbar:

Feldwert	Typ	Beschreibung
created_at	Datum (ISO 8601)	Erstellungszeitpunkt der Community.
id	string	Der eindeutige Bezeichner der Community.
name	string	Der Name der Community.
description	string	Der Text der Community-Beschreibung, falls vorhanden.
access	string	Die Zugriffsebene der Community. Kann einen der folgenden Werte haben: * Public * Closed
join_policy	string	Die Beitrittsrichtlinie der Community. Kann einen der folgenden Werte haben: * Open * RestrictedJoinRequestsDisabled * RestrictedJoinRequestsRequireAdminApproval * RestrictedJoinRequestsRequireModeratorApproval * SuperFollowRequired
member_count	integer	Die Anzahl der Mitglieder, die der Community beigetreten sind.

​

Beispielanfrage

Sie können den Communities Lookup endpoint mit zusätzlichen Community fields wie unten gezeigt aufrufen (unter Verwendung der 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: ••••••'

Beispielantwort

Wenn die Anfrage erfolgreich ist, sollten Sie die JSON-Antwort wie unten gezeigt sehen:

{
    "data": {
        "description": "Willkommen in der Anime-Community! Hier versammeln sich Anime-Fans, um ihre Lieblingssendungen zu teilen und alles rund um Anime zu diskutieren.",
        "access": "Öffentlich",
        "member_count": 40369,
        "created_at": "2024-02-17T06:58:50.000Z",
        "join_policy": "Offen",
        "name": "Anime-Community",
        "id": "Q29tbXVuaXR5OjE3NTg3NDc4MTc2NDI3MDA5MjI="
    }
}