Schnellstart

​

Erste Schritte mit der Endpoint‑Gruppe „Lists verwalten“

Diese kurze Übersicht hilft Ihnen, Ihre erste Anfrage an die Manage‑List‑Endpoints mit Postman zu senden.

Wenn Sie Beispielcode in verschiedenen Sprachen sehen möchten, besuchen Sie bitte unser GitHub‑Repository X API v2 Sample Code. 

Hinweis: In diesem Beispiel senden wir eine Anfrage an den Endpoint Create a List, aber die in diesem Schnellstart vermittelten Inhalte lassen sich auch auf andere Manage‑Anfragen anwenden.

Voraussetzungen

Um diese Anleitung abzuschließen, benötigen Sie einen Satz von Keys und Tokens, um Ihre Anfrage zu authentifizieren. Sie können diese Keys und Tokens generieren, indem Sie die folgenden Schritte ausführen:

• Registrieren Sie sich für ein Developer-Konto und lassen Sie es genehmigen.
• Erstellen Sie ein Project und eine zugehörige Developer-App im Entwicklerportal.
• Navigieren Sie zur Seite „Keys und Tokens“ Ihrer App, um die erforderlichen Anmeldedaten zu generieren. Stellen Sie sicher, dass Sie alle Anmeldedaten an einem sicheren Ort speichern.

​

Schritte zum Erstellen einer Manage-List-Anfrage

Schritt eins: Beginnen Sie mit einem Tool oder einer Bibliothek

Es gibt mehrere Tools, Codebeispiele und Bibliotheken, mit denen Sie eine Anfrage an dieses endpoint stellen können; hier verwenden wir Postman, um den Prozess zu vereinfachen.

Um die X API v2 Postman-Collection in Ihre Umgebung zu laden, klicken Sie bitte auf die folgende Schaltfläche:

X API v2 zu Postman hinzufügen

Sobald Sie die X API v2-Collection in Postman geladen haben, navigieren Sie zum Ordner „List“, wählen Sie den Ordner „Manage List“ und dann „Create a List“.

Schritt zwei: Authentifizieren Sie Ihre Anfrage

Um korrekt eine Anfrage an die X API zu stellen, müssen Sie verifizieren, dass Sie die Berechtigung dazu haben. Für die Manage-Posts-endpoints müssen Sie Ihre Anfrage entweder mit OAuth 1.0a User Context oder OAuth 2.0 Authorization Code with PKCE authentifizieren.

In diesem Beispiel verwenden wir OAuth 1.0a User Context.

Fügen Sie Ihre Keys und Tokens (insbesondere Ihren API Key, API Secret Key, OAuth 1.0a user Access Token und OAuth 1.0a user Access Token Secret) in Postman hinzu. Wählen Sie dazu die Umgebung „X API v2“ (oben rechts in Postman) und tragen Sie Ihre Keys und Tokens in die Felder „initial value“ und „current value“ ein (über das Augensymbol neben dem Umgebungs-Dropdown).

Wenn Sie dies korrekt erledigt haben, werden diese Variablen automatisch in den Authorization-Tab der Anfrage übernommen.   Schritt drei: Geben Sie den Namen für die neue List an

Beim Erstellen einer neuen List mit diesem endpoint ist ein Name für die List ein erforderlicher Body-Parameter. Optional können Sie eine Beschreibung angeben und festlegen, ob die List privat ist.

In Postman wechseln Sie zum Tab „Body“ und geben den Namen der List als Wert für den Parameter name ein. Wenn Sie zusätzlich eine Beschreibung für die List hinzufügen möchten, fügen Sie einfach einen neuen Schlüssel mit der Bezeichnung description in gleicher Weise wie den Namen hinzu, gefolgt von der Beschreibung der List als Wert. Das Setzen einer List auf privat folgt dem gleichen Muster, allerdings werden für diesen Parameter nur die Werte true oder false akzeptiert. 

Key	Value	Parameter type
name	Name der List (erforderlich)	body
description	Beschreibung für die List (optional)	body
private	true oder false (optional)	body

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

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

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

Sobald Sie alles eingerichtet haben, klicken Sie auf die „Send“-Schaltfläche, und Sie erhalten eine ähnliche Antwort wie im folgenden Beispiel:

{
  "data": {
    "id": "1441162269824405510",
    "name": "Neue Liste erstellt mit Postman"
  }
}

Wenn das zurückgegebene Response-Objekt eine id und den Namen Ihrer List enthält, haben Sie die List erfolgreich erstellt. 

Um eine List zu löschen, wählen Sie die Anfrage „Delete a List“, die sich ebenfalls im Ordner „Lists“ der in Postman geladenen X API v2 Collection befindet. Dieses endpoint erfordert die ID der List, die Sie löschen möchten. Geben Sie im Tab „Params“ die ID der List, die Sie löschen möchten, als Wert für die Spalte id ein. 

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

{
  "data": {
    "deleted": true
  }
}