List-Mitglieder verwalten

​

Schnellstartleitfaden: Mitglieder einer List verwalten

Bitte beachten: Dieser Leitfaden setzt voraus, dass Sie die Voraussetzungen aus der Schnellstartübersicht erfüllt haben.

​

Schritte zum Erstellen einer Anfrage zum Verwalten von List-Mitgliedern

​

Schritt eins: Wählen Sie die List-endpoint-Sammlung in Postman

Sobald Sie die X API v2-Sammlung in Postman geladen haben, navigieren Sie zum Ordner „List“, wählen Sie den Ordner „List members“ und anschließend „Add a member“.  

​

Schritt zwei: Geben Sie den hinzuzufügenden Nutzer an

Die Endpoints zum Verwalten von List-Mitgliedern erfordern zwei IDs: die ID der List und die ID des hinzuzufügenden Nutzers. Sie können die Nutzer-ID mit der users lookup ermitteln, indem Sie einen Benutzernamen übergeben, um das Feld id zu erhalten.

Die Ziel-ID kann eine beliebige gültige Nutzer-ID sein. Navigieren Sie in Postman zur Registerkarte „Params“ und geben Sie Ihre ID in die Spalte „Value“ der id-Pfadvariable ein. Navigieren Sie zur Registerkarte „Body“ und geben Sie die ID des Nutzers, den Sie hinzufügen möchten, als Wert für den Parameter user_id ein. Achten Sie darauf, vor oder nach einer ID keine Leerzeichen einzufügen.

Key	Value	Parameter type
id	Die List-ID	path
user_id	Die Ziel-Nutzer-ID, die Sie als Mitglied hinzufügen möchten	body

Neben der Schaltfläche „Send“ sollten Sie nun eine ähnliche URL sehen:

https://api.x.com/2/lists/1441162269824405510/members

Schritt drei: Senden Sie Ihre Anfrage und prüfen Sie Ihre Antwort

Sobald alles eingerichtet ist, klicken Sie auf die Schaltfläche „Send“, und Sie erhalten eine Antwort, die der folgenden Beispielantwort ähnelt:

{
  "data": {
    "is_member": true
  }
}

Wenn das zurückgegebene Response-Objekt für den Schlüssel is_member den Wert true enthält, haben Sie den Benutzer erfolgreich als Mitglied der List hinzugefügt. 

Um ein Mitglied aus einer List zu entfernen, wählen Sie die Anforderung „Remove a member“, die sich ebenfalls im Ordner „Lists“ der in Postman geladenen X API v2-Sammlung befindet. Dieses endpoint erfordert die ID der List und die Benutzer-ID des Mitglieds, das Sie entfernen möchten. Geben Sie im Tab „Params“ die ID der List als Wert für die Spalte id und die ID des zu entfernenden Benutzers als Wert für die Spalte user_id ein. 

Bei einer erfolgreichen DELETE-Anfrage erhalten Sie eine Antwort ähnlich dem folgenden Beispiel:

{
  "data": {
    "is_member": false
  }
}