Lesezeichen verwalten

​

Erste Schritte mit den Manage-Bookmarks-endpoints

Diese Schnellstartanleitung hilft Ihnen, mit Postman Ihre erste Anfrage an die Manage-Bookmarks-endpoints zu stellen.

Wenn Sie Beispielcode in verschiedenen Sprachen sehen möchten, besuchen Sie bitte unser GitHub-Repository mit dem X API v2 Beispielcode.

Voraussetzungen

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

• Melden Sie sich für ein Developer-Konto an 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 Anfrage zum Verwalten von Lesezeichen

Schritt eins: Beginnen Sie mit einem Tool oder einer Bibliothek

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

Um die X API v2 Postman-Sammlung 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-Sammlung in Postman geladen haben, navigieren Sie zum Ordner „Bookmarks“ und wählen Sie „Create a Bookmark“.

Schritt zwei: Authentifizieren Sie Ihre Anfrage

Um eine erfolgreiche Anfrage an dieses endpoint zu stellen, müssen Sie OAuth 2.0 Authorization Code Flow with PKCE verwenden. Sie können in Postman ein access token generieren.

Gehen Sie zur Registerkarte „Authorization“ und wählen Sie „OAuth 2.0“ aus.

Befolgen Sie in dieser Registerkarte diese Schritte:

1. Benennen Sie Ihr Token.

2. Wählen Sie als Grant Type Authorization Code (with PKCE).

3. Aktualisieren Sie die Parameter:

   Callback URL - https://www.example.com

   Diese muss mit der Callback-URL übereinstimmen, die Sie auf Ihrer Seite mit den Authentifizierungseinstellungen im Entwicklerportal festgelegt haben.

   Auth URL - https://x.com/i/oauth2/authorize

   Access Token URL - https://api.x.com/2/oauth2/token

   Client ID - OAuth 2.0 Client ID aus dem Entwicklerportal kopieren und einfügen

   Client Secret - OAuth 2.0 Client Secret aus dem Entwicklerportal kopieren und einfügen. Sie benötigen dies nur, wenn Sie einen App-Typ verwenden, der ein vertraulicher Client ist.

4. Aktualisieren Sie die Scopes mit den folgenden Werten: post.read users.read bookmark.write

5. Füllen Sie das Feld state mit „State“.

6. Klicken Sie auf „Generate Token“.

7. Klicken Sie auf das Speicher-Symbol, um die Änderungen am Ordner zu speichern.

Es kann sein, dass Sie die Meldung erhalten, dass Sie nicht bei X angemeldet sind. Wenn dieser Fehler auftritt, müssen Sie sich in dem X-Konto innerhalb von Postman anmelden, in dessen Namen Sie posten möchten.

Schritt drei: Geben Sie einen Nutzer an

Bei diesem endpoint müssen Sie die Nutzer-ID angeben, deren Follower Sie in der Antwort erhalten möchten. Zum Beispiel lautet die Nutzer-ID für @XDevelopers 2244994945.

Navigieren Sie in Postman zur Registerkarte „Params“ und geben Sie die ID von Ihnen selbst oder eines authentifizierten Nutzers als Wert für den Parameter id ein.

	Key	Value
	id	2244994945

Schritt vier: Geben Sie den Post an, den Sie mit einem Lesezeichen versehen möchten

Navigieren Sie zur Registerkarte „Body“ und stellen Sie sicher, dass die Post-ID auf den Post gesetzt ist, den Sie in Ihren Lesezeichen speichern möchten. Die JSON-Nutzlast sollte ähnlich wie unten aussehen.

      {"tweet_id": "1460323737035677698"}

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

Sobald alles eingerichtet ist, klicken Sie auf die Schaltfläche „Senden“, und Sie erhalten eine Antwort, die dem folgenden Beispiel ähnelt:

{
   "data": {
       "bookmarked": true
   }
}

Um einen Post zu löschen, wählen Sie die Anfrage „Remove a Bookmark“, die sich ebenfalls im Ordner „Bookmarks“ der in Postman geladenen X API v2 Collection befindet. Geben Sie zunächst die Benutzer-ID des Nutzers, in dessen Namen Sie die Anfrage stellen, als Wert für die Spalte „id“ an. Dieses Endpoint erfordert außerdem die ID des Posts, den Sie löschen möchten. Geben Sie anschließend im Tab „Params“ die ID des Posts, den Sie löschen möchten, als Wert für die Spalte „tweet_id“ ein. 

Wenn Ihre DELETE-Anfrage erfolgreich ist, erhalten Sie eine Antwort ähnlich dem folgenden Beispiel:

{
   "data": {
       "bookmarked": false
   }
}