Zum Hauptinhalt springen
Diese Seite enthält Informationen zu mehreren Tools und wichtigen Konzepten, die Sie kennen sollten, wenn Sie die Blocks-endpoints in Ihr System integrieren. Wir haben die Seite in mehrere Abschnitte unterteilt:

​
Nützliche Tools

Bevor wir auf einige Schlüsselkonzepte eingehen, die Ihnen bei der Integration dieses endpoint helfen, empfehlen wir, sich mit Folgendem vertraut zu machen:

​
Postman

Postman ist ein hervorragendes Tool, mit dem Sie ein Endpoint testen können. Jede Postman-Anfrage enthält alle Pfad- und Body-Parameter, sodass Sie schnell verstehen, welche Optionen Ihnen zur Verfügung stehen. Weitere Informationen zu unseren Postman-Collections finden Sie auf unserer Seite “Using Postman”. 

​
Codebeispiele

Möchten Sie dieses endpoint mit etwas Code in Ihrer bevorzugten Programmiersprache einrichten? Wir haben eine Reihe unterschiedlicher Codebeispiele bereitgestellt, die Sie als Ausgangspunkt auf unserer GitHub-Seite verwenden können.

​
Bibliotheken von Drittanbietern

Nutzen Sie eine der Bibliotheken von Drittanbietern aus unserer Community, um den Einstieg zu erleichtern. Sie können eine Bibliothek finden, die mit den v2-endpoints funktioniert, indem Sie nach dem entsprechenden Versions-Tag suchen.

​
Wichtige Konzepte

​
Authentifizierung

Alle X API v2 endpoints erfordern, dass Sie Ihre Anfragen mit einem Satz von Zugangsdaten authentifizieren, auch bekannt als Keys und Tokens. Sie können entweder OAuth 1.0a User Context oder OAuth 2.0 Authorization Code mit PKCE verwenden, um Ihre Anfragen an diese endpoints zu authentifizieren. OAuth 1.0a User Context erfordert, dass Sie Ihre API Keys, Benutzer-Access Tokens und einige weitere Parameter verwenden, um einen Authorization-Header zu erstellen, den Sie anschließend mit Ihrer Anfrage übermitteln. Die Access Tokens müssen dem Benutzer zugeordnet sein, in dessen Namen Sie die Anfrage stellen. Wenn Sie einen Satz von Access Tokens für einen anderen Benutzer generieren möchten, muss dieser Ihre App mithilfe des 3-legged OAuth-Flow autorisieren. Bitte beachten Sie, dass OAuth 1.0a schwierig zu verwenden sein kann. Wenn Sie mit dieser Authentifizierungsmethode nicht vertraut sind, empfehlen wir, eine library zu verwenden, ein Tool wie Postman zu nutzen oder OAuth 2.0 zu verwenden, um Ihre Anfragen zu authentifizieren. OAuth 2.0 Authorization Code mit PKCE ermöglicht eine umfassendere Kontrolle über den Scope einer Anwendung sowie Autorisierungsabläufe über mehrere Geräte hinweg. OAuth 2.0 erlaubt es Ihnen, spezifische, fein granulare Scopes auszuwählen, die Ihnen bestimmte Berechtigungen im Namen eines Benutzers erteilen. Um OAuth 2.0 in Ihrer App zu aktivieren, müssen Sie es in den Authentifizierungseinstellungen Ihrer App aktivieren, die Sie im Bereich App-Einstellungen des Entwicklerportals finden.

​
Entwicklerportal, Projects und Developer-Apps

Um einen Satz von Authentifizierungsdaten zu erhalten, der mit den X API v2 endpoints funktioniert, müssen Sie sich für ein Developer-Konto registrieren, ein Project innerhalb dieses Kontos einrichten und eine Developer-App innerhalb dieses Projects erstellen. Anschließend finden Sie Ihre Keys und Tokens in Ihrer Developer-App.  

​
Rate Limits

Jeden Tag stellen viele Tausend Entwickler Anfragen an die X API. Um das hohe Volumen dieser Anfragen zu steuern, gelten für jedes endpoint Rate Limits, die die Anzahl der Anfragen begrenzen, die Sie im Namen Ihrer App oder eines authentifizierten Benutzers stellen können. Diese endpoints sind auf Benutzerebene rate-limited. Das bedeutet, dass der authentifizierte Benutzer, in dessen Namen Sie die Anfrage stellen, das endpoint über jede Developer-App hinweg nur eine bestimmte Anzahl von Malen aufrufen kann. Es gilt ein Benutzer-Rate Limit von 50 Anfragen pro 15 Minuten und pro endpoint für die Methoden POST und DELETE. Mit der Methode GET beträgt das Rate Limit jedoch nur 15 Anfragen pro 15 Minuten.  

​
Felder und expansions

Die X API v2 GET-endpoints ermöglichen es Nutzern, mithilfe eines Sets von Tools namens fields und expansions genau auszuwählen, welche data sie aus der API zurückgeben möchten. Der expansions-Parameter ermöglicht es, in der Nutzlast referenzierte Objekte zu erweitern. Zum Beispiel erlaubt dieser endpoint, die folgenden expansions abzurufen:
  • pinned_tweet_id
Der fields-Parameter ermöglicht es Ihnen, genau auszuwählen, welche fields innerhalb der verschiedenen Datenobjekte Sie erhalten möchten. Diese endpoints liefern hauptsächlich Post-Objekte. Standardmäßig gibt das Post-Objekt die id- und text-Felder zurück. Um zusätzliche Felder wie tweet.created_at oder tweet.entities zu erhalten, müssen Sie diese ausdrücklich über einen fields-Parameter anfordern. Einige wichtige Felder, die Sie in Ihrer Integration berücksichtigen sollten, sind unsere Umfragedaten, metrics, Post-Annotations und Felder für Konversations-IDs. Wir haben unserer X API v2 data dictionary eine Anleitung hinzugefügt, wie Sie fields und expansions verwenden. Die Blocks-Abfrage kann eine große Menge an data zurückgeben. Um sicherzustellen, dass wir nicht zu viele Ergebnisse auf einmal liefern, verwenden wir Paginierung. Erfahren Sie mehr darüber, wie Sie Ergebnisse paginieren.
⌘I