Zum Hauptinhalt springen

​
Einstieg in das Bookmarks-Lookup-endpoint

Dieser Schnellstart-Leitfaden hilft Ihnen, mit Postman Ihre erste Anfrage an das Bookmarks-Lookup-endpoint zu stellen. Besuchen Sie unser GitHub-Repository mit X API v2 Beispielcode, wenn Sie Beispielcode in verschiedenen Sprachen sehen möchten.

​
Voraussetzungen

Um diese Anleitung abzuschließen, benötigen Sie ein Set aus 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 Zugangsdaten zu generieren. Stellen Sie sicher, dass Sie alle Zugangsdaten an einem sicheren Ort speichern.

​
Schritte zum Erstellen einer Bookmarks-Lookup-Anfrage

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-Collection in Ihre Umgebung zu laden, klicken Sie bitte auf den folgenden Button:
Sobald Sie die X API v2-Collection in Postman geladen haben, navigieren Sie zum Ordner „Bookmarks“ und wählen Sie „Bookmarks lookup“. 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. Achten Sie in dieser Registerkarte darauf, diese Schritte zu befolgen:
  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 Auth-Einstellungsseite im Entwicklerportal festgelegt haben. Auth URL - https://x.com/i/oauth2/authorize Access Token URL - https://api.x.com/2/oauth2/token Client ID - Kopieren Sie die OAuth 2.0 Client ID aus dem Entwicklerportal. Client Secret - Kopieren Sie das OAuth 2.0 Client Secret aus dem Entwicklerportal. 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.read
  5. Befüllen Sie das Feld state mit „State“.
  6. Klicken Sie auf „Generate Token“.
  7. Klicken Sie auf das Speicher-Icon, um die Änderungen am Ordner zu speichern.
Möglicherweise erhalten Sie eine Meldung, 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. Beispiel: Die Nutzer-ID für @XDevelopers ist 2244994945. Navigieren Sie in Postman zur Registerkarte „Params“ und geben Sie die ID von sich selbst oder eines authentifizierten Nutzers als Wert für den Parameter id ein.
KeyValue
id2244994945
Schritt vier: Senden Sie Ihre Anfrage und prü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": [
       {
           "id": "1501258597237342208",
           "text": "🗣 Haben Sie ein Projekt mit der X API entwickelt, das Sie mit der Community teilen möchten? Wir würden gerne von Ihnen hören. Teilen Sie Ihr Projekt mit uns!"
       },
       {
           "id": "1501258542258348032",
           "text": "🧰🛠 Dies ist nur eine Möglichkeit, wie Entwicklerinnovation dazu beiträgt, Twitter zu einem besseren Ort zu machen. Weitere gebrauchsfertige Tools, die von unserer Entwickler-Community erstellt wurden, finden Sie in unserer Twitter Toolbox hier ⬇️ https://t.co/rK0X30JSYU"
       },
       {
           "id": "1501257716941000709",
           "text": "📣Heute ist ein wichtiger Tag! \nWir haben uns mit @Jigsaw für die Einführung dieses neuen Tools zusammengetan. Diese Zusammenarbeit ermöglicht es NGOs und gemeinnützigen Organisationen, Tools zu entwickeln, die Menschen dabei helfen, auf Twitter sicher zu bleiben, indem sie die Bedürfnisse und Präferenzen der Gemeinschaften berücksichtigen, denen sie dienen. Mehr erfahren ⬇️ https://t.co/MmznmgxoWT"
       },
       {
           "id": "1501686770810900485",
           "text": "Begleiten Sie uns morgen zu einem weiterführenden Gespräch über die Anpassung von Timelines und wie dies für Entwickler funktionieren könnte. Und bleiben Sie dran für weitere Spaces, die nächste Woche kommen. 👀 https://t.co/P4JTc14mdC"
       },
       {
           "id": "1501596763194593285",
           "text": "Entwicklerinnovation ist immer wichtig, auch in Krisenzeiten. Wenn Sie Tools entwickeln, die Menschen verbinden, sie schützen oder Informationen mit der Welt teilen, sind wir hier, um Sie zu unterstützen – antworten Sie auf diesen Tweet, um uns mehr über Ihre App zu erzählen."
       }
   ]
}
⌘I