Schnellstart

​

Erste Schritte mit den Posts-Lookup-endpoints

Dieser Schnellstart-Leitfaden hilft Ihnen, Ihre erste Anfrage an die Posts-Lookup-endpoints mit einem Satz definierter fields mithilfe von Postman zu stellen.

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

​

Voraussetzungen

Um diesen Leitfaden 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 „Keys and tokens“-Seite Ihrer App, um die erforderlichen Zugangsdaten zu generieren. Stellen Sie sicher, dass Sie alle Zugangsdaten an einem sicheren Ort speichern.

​

Schritte zum Erstellen einer GET-/tweets-Anfrage

​

Schritt eins: Beginnen Sie mit einem Tool oder einer Bibliothek

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

Um die X API v2 Postman-Collection in Ihre Umgebung zu laden, klicken Sie 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 zur Anfrage „Post Lookup > Multiple Posts“.

​

Schritt zwei: Authentifizieren Sie Ihre Anfrage

Um eine Anfrage an die X API korrekt zu stellen, müssen Sie Ihre Berechtigung nachweisen. Sie können Ihre Anfrage authentifizieren mit:

• OAuth 2.0 App-Only
• OAuth 2.0 Authorization Code mit PKCE
• OAuth 1.0a User Context

Der Einfachheit halber verwenden wir für diese Anfrage OAuth 2.0 App-Only. Wenn Sie jedoch private metrics oder Posts anfordern möchten, müssen Sie eine der anderen Authentifizierungsmethoden verwenden.

Um OAuth 2.0 App-Only zu nutzen, müssen Sie Ihre Keys und Tokens (insbesondere das App Access Token, auch bekannt als App-only Bearer Token) zu Postman hinzufügen, indem Sie die Umgebung mit dem Namen „X API v2“ auswählen (in der oberen rechten Ecke von Postman) und Ihre Keys und Tokens in die Felder „initial value“ und „current value“ eintragen (indem Sie auf das Augensymbol neben dem Umgebungs-Dropdown klicken).

Wenn Sie dies korrekt durchgeführt haben, werden diese Variablen automatisch im Authorization-Tab der Anfrage verwendet.

​

Schritt drei: Bestimmen und angeben, welche Posts Sie abrufen möchten

Sie müssen in der Anfrage einen Post oder eine Menge von Posts angeben, die Sie abrufen möchten. Die Post-ID finden Sie, indem Sie zu X.com navigieren, einen Post öffnen und in der URL nachsehen. Die Post-ID der folgenden URL ist zum Beispiel 1228393702244134912.

https://x.com/TwitterDev/status/1228393702244134912

Navigieren Sie in Postman zum Tab „Params“ und tragen Sie diese ID – oder eine durch Kommas getrennte Liste von Post-IDs – in die Spalte „Value“ des Parameters ids ein.

Key	Value
ids	1228393702244134912,1227640996038684673,1199786642791452673

---

​

Schritt vier: Identifizieren und angeben, welche fields Sie abrufen möchten

Wenn Sie nach Schritt drei auf die Schaltfläche „Send“ klicken, erhalten Sie in Ihrer Antwort die standardmäßigen Post object fields: id, text und edit_history_tweet_ids.

Für diese Übung fordern wir drei zusätzliche, unterschiedliche Sets von fields aus verschiedenen Objekten an:

• Das zusätzliche tweet.created_at field in den primären Nutzerobjekten.
• Die zugehörigen Standardfelder des User-Objekts der Autoren für die zurückgegebenen Posts: id, name und username
• Das zusätzliche user.created_at field in den zugehörigen Nutzerobjekten.

Navigieren Sie in Postman zur Registerkarte „Params“ und fügen Sie das folgende key:value-Paar zur Tabelle „Query Params“ hinzu:

Key	Value	Returned fields
tweet.fields	created_at	tweets.created_at
expansions	author_id	includes.users.id, includes.users.name, includes.users.username
user.fields	created_at	includes.users.created_at

Sie sollten diese URL neben der Schaltfläche „Send“ sehen:

https://api.x.com/2/tweets?ids=1228393702244134912,1227640996038684673,1199786642791452673&tweet.fields=created_at&expansions=author_id&user.fields=created_at

​

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

Sobald alles eingerichtet ist, klicken Sie auf die Schaltfläche „Send“ und Sie erhalten die folgende Antwort:

{
    "data": [
        {
            "edit_history_tweet_ids": [
                "1228393702244134912"
            ],
            "text": "Was hat der Entwickler in seine Valentinstagskarte geschrieben?\n  \nwhile(true) {\n    I = Love(You);  \n}",
            "id": "1228393702244134912",
            "created_at": "2020-02-14T19:00:55.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1227640996038684673"
            ],
            "text": "Ärzte: Das Googeln von Sachen im Internet macht einen noch nicht zum Arzt\n\nEntwickler: https://t.co/mrju5ypPkb",
            "id": "1227640996038684673",
            "created_at": "2020-02-12T17:09:56.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1199786642791452673"
            ],
            "text": "C#",
            "id": "1199786642791452673",
            "created_at": "2019-11-27T20:26:41.000Z",
            "author_id": "2244994945"
        }
    ],
    "includes": {
        "users": [
            {
                "name": "Entwickler",
                "created_at": "2013-12-14T04:35:55.000Z",
                "id": "2244994945",
                "username": "XDevelopers"
            }
        ]
    }
}