Angepinnte Lists verwalten

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

​

Schritte zum Erstellen einer Anfrage zum Verwalten angehefteter Lists

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

Sobald Sie die X API v2-Sammlung in Postman geladen haben, navigieren Sie zum Ordner „List“, wählen Sie den Ordner „Pinned Lists“ und wählen Sie dann „Pin a List“.  

Schritt zwei: Geben Sie die List an, die angeheftet werden soll

Endpoints zum Verwalten angehefteter Lists erfordern zwei IDs: eine für den Nutzer (der authentifizierte Nutzer, der eine List anheftet) und die Ziel-List (die List, die angeheftet werden soll). Die ID des Nutzers muss der ID des authentifizierenden Nutzers entsprechen, was bedeutet, dass Sie beim Authentifizieren Ihrer Anfrage die mit der Nutzer-ID verknüpften Access Tokens übergeben müssen. In diesem Fall können Sie die ID angeben, die zu Ihrem Nutzer gehört. Ihre ID können Sie auf zwei Arten finden:

1. Mit dem Endpoint users lookup nach Benutzername können Sie einen Benutzernamen übergeben und erhalten das Feld id.
2. Im Access Token ist der numerische Teil Ihre Nutzer-ID.

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

Key	Value	Parameter type
id	Die Nutzer-ID	path
list_id	Die Ziel-List-ID, die angeheftet werden soll	body

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

      https://api.x.com/2/users/2244994945/pinned_lists

Schritt drei: Senden Sie Ihre Anfrage und überprüfen Sie die Antwort

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

{
  "data": {
    "pinned": true
  }
}

Sie haben die Ziel-List erfolgreich angeheftet, wenn das zurückgegebene Response-Objekt für den Schlüssel pinned den Wert true enthält. 

Um eine List zu lösen, wählen Sie die Anfrage „Unpin List“, die sich ebenfalls im Ordner „Lists“ der in Postman geladenen X API v2-Kollektion befindet. Dieses endpoint erfordert die ID des authentifizierten Nutzers und die ID der zu lösenden List. Geben Sie im Tab „Params“ die Nutzer-ID als Wert für die Spalte id und die ID der zu lösenden List als Wert für die Spalte list_id ein. 

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

{
  "data": {
    "pinned": false
  }
}