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

​
Nützliche Tools

Bevor wir auf einige zentrale Konzepte 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, damit Sie schnell nachvollziehen können, was verfügbar ist. Weitere Informationen zu unseren Postman-Collections finden Sie auf der Seite “Using Postman”. 

​
Codebeispiele

Möchten Sie dieses endpoint mit Code in Ihrer bevorzugten Programmiersprache einrichten? Auf unserer GitHub-Seite finden Sie mehrere Codebeispiele, die Sie als Ausgangspunkt verwenden können.

​
Bibliotheken von Drittanbietern

Nutzen Sie eine der Bibliotheken von Drittanbietern aus unserer Community, um den Einstieg zu erleichtern. Sie finden Bibliotheken, die mit den v2 endpoints arbeiten, indem Sie nach dem passenden Versionstag suchen.  

​
Zentrale Konzepte

​
Authentifizierung

Alle X API v2 endpoints erfordern, dass Sie Ihre Anfragen mit einem Satz von Anmeldeinformationen authentifizieren, auch bekannt als Keys und Tokens. Sie können entweder OAuth 1.0a User Context oder OAuth 2.0 Bearer Token verwenden, um Ihre Anfragen an den Retweets lookup endpoint zu authentifizieren. Die manage Retweets endpoints erfordern die Verwendung von OAuth 1.0a User Context. Das bedeutet, dass Sie einen Satz von API Keys und Benutzer-Access Tokens verwenden müssen, um eine erfolgreiche Anfrage zu stellen. 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 über den 3-legged OAuth-Flow autorisieren oder authentifizieren. Bitte beachten Sie, dass OAuth 1.0a mitunter knifflig sein kann. Wenn Sie mit dieser Authentifizierungsmethode nicht vertraut sind, empfehlen wir, eine Bibliothek zu verwenden, um Ihre Anfragen korrekt zu authentifizieren. Bitte beachten Wenn Sie die folgenden fields anfordern, ist OAuth 1.0a User Context erforderlich:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

​
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 senden 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 Nutzers stellen können. Die manage Retweets endpoints sind auf 50 Anfragen pro 15 Min (pro Nutzer) begrenzt. Zusätzlich sind Sie für das POST endpoint auf 300 Anfragen pro 3‑Stunden‑Fenster (pro Nutzer, pro App) begrenzt.  Beim Retweets lookup endpoint sind Sie auf 75 Anfragen pro 15‑Minuten‑Fenster begrenzt. Außerdem gibt dieses endpoint nur die 100 zuletzt Retweetenden Nutzer zurück.

​
Felder und Expansions

Die X API v2 ermöglicht es Nutzern, mithilfe von fields und expansions genau festzulegen, welche data sie von der API zurückerhalten möchten. Der Parameter expansions ermöglicht es, Objekte einzubinden, auf die in der Nutzlast verwiesen wird. Dieses endpoint unterstützt beispielsweise die folgenden expansions:
  • attachments.poll_ids
  • attachments.media_keys
  • author_id, entities.mentions.username
  • geo.place_id
  • in_reply_to_user_id,
  • referenced_tweets.id,
  • referenced_tweets.id.author_id
Der Parameter fields ermöglicht es, genau die fields innerhalb der verschiedenen Datenobjekte auszuwählen, die Sie erhalten möchten. Diese endpoints liefern hauptsächlich Post-Objekte. Standardmäßig gibt das Post-Objekt die Felder id und text 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 für Ihre Integration in Betracht ziehen sollten, sind unsere Poll-Daten, metrics, Post-Annotations und Felder für die conversation ID. Wir haben unserem X API v2 data dictionary eine Anleitung hinzugefügt, wie Sie fields und expansions gemeinsam verwenden.
⌘I