Zum Hauptinhalt springen
Diese Seite enthält Informationen zu mehreren Tools und wichtigen Konzepten, die Sie kennen sollten, wenn Sie das List-Posts-Lookup-endpoint in Ihr System integrieren. 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 sämtliche Pfad- und Body-Parameter, damit Sie schnell verstehen, was Ihnen zur Verfügung steht. Weitere Informationen zu unseren Postman-Collections finden Sie auf der Seite “Using Postman”. 

​
Codebeispiele

Möchten Sie dieses endpoint mit etwas Code in Ihrer bevorzugten Programmiersprache einrichten? Wir haben eine Reihe verschiedener 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 passenden Versions-Tag suchen.

​
Zentrale Konzepte

​
Authentifizierung

Alle X API v2 endpoints erfordern, dass Sie Ihre Anfragen mit einem Satz von Anmeldedaten authentifizieren, auch bekannt als Keys und Tokens. Sie können entweder OAuth 1.0a User Context, App only oder OAuth 2.0 Authorization Code mit PKCE verwenden, um Ihre Anfragen an dieses endpoint zu authentifizieren.  OAuth 1.0a User Context, was 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 mit dem Benutzer verknüpft sein, in dessen Namen Sie die Anfrage stellen. Wenn Sie einen Satz von Access Tokens für einen anderen Benutzer erzeugen 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 entweder OAuth 2.0 oder App only zu verwenden, um Ihre Anfragen zu authentifizieren. OAuth 2.0 Authorization Code mit PKCE ermöglicht eine feinere 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 geben.  Um OAuth 2.0 in Ihrer App zu aktivieren, müssen Sie es in den Authentifizierungseinstellungen Ihrer App aktivieren, die im Bereich App-Einstellungen des Entwicklerportals zu finden sind. App only erfordert lediglich, dass Sie Ihrer Anfrage einen App only Access Token beifügen. Sie können einen App only Access Token entweder direkt innerhalb einer Developer-App generieren oder einen mithilfe des POST oauth2/token endpoint erzeugen.

​
Entwicklerportal, Projects und Developer-Apps

Um eine Reihe von Authentifizierungsdaten zu erhalten, die mit den X API v2 endpoints funktionieren, müssen Sie sich für ein Developer-Konto registrieren, in diesem Konto ein Project einrichten und innerhalb dieses Projects eine Developer-App 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 verwalten, werden auf jedem endpoint Rate Limits festgelegt, die die Anzahl der Anfragen einschränken, die Sie im Namen Ihrer App oder eines authentifizierten Nutzers stellen können.  Dieses endpoint ist sowohl auf App-Ebene als auch auf Nutzer-Ebene ratebegrenzt. Das App-Rate Limit bedeutet, dass Sie als Entwickler nur eine bestimmte Anzahl von Anfragen an dieses endpoint innerhalb eines bestimmten Zeitraums von einer beliebigen App aus stellen können (unter Verwendung entweder des API Key und API Secret Key oder des Bearer Token). Das Nutzer-Rate Limit bedeutet, dass der authentifizierte Nutzer, in dessen Namen Sie die Anfrage stellen, eine List-Post-Abfrage nur eine bestimmte Anzahl von Malen über jede beliebige Developer-App ausführen kann. Die folgende Tabelle zeigt die Rate Limits für jedes endpoint.
EndpointHTTP-MethodeRate Limit
/2/lists/:id/tweetsGET900 requests per 15 minutes
Fields und expansions Das X API v2 GET endpoint ermöglicht es Nutzern, mithilfe von Werkzeugen namens fields und expansions genau auszuwählen, welche data sie von der API zurückgeben lassen möchten. Der Parameter expansions ermöglicht es Ihnen, Objekte zu erweitern, auf die in der Nutzlast verwiesen wird. Beispielsweise können Sie beim Nachschlagen von List Posts die folgenden expansions abrufen:
  • author_id
Der Parameter fields ermöglicht es Ihnen, genau auszuwählen, welche fields innerhalb der verschiedenen Datenobjekte Sie erhalten möchten. Dieses endpoint liefert in erster Linie Post-Objekte. Standardmäßig gibt das Post-Objekt die id- und text-fields zurück. Um zusätzliche Felder wie tweet.created_at oder tweet.lang zu erhalten, müssen Sie diese ausdrücklich mit einem fields-Parameter anfordern.  Wir haben unserem X API v2 data dictionary eine Anleitung zur gemeinsamen Verwendung von fields und expansions hinzugefügt.  Die folgende Tabelle zeigt die für das Lookup-endpoint verfügbaren fields und expansions:
EndpointFieldsExpansions
/2/lists/:id/tweetstweet.fields

user.fields		author_id
Paginierung Das Nachschlagen von List Posts kann viele data zurückgeben. Um sicherzustellen, dass wir jederzeit konsistente, leistungsstarke Ergebnisse liefern, verwenden wir Paginierung. Paginierung ist eine Funktion in X API v2 endpoints, die mehr Ergebnisse zurückgeben, als in einer einzelnen Antwort zurückgegeben werden können. In diesem Fall werden die data in einer Reihe von „Seiten“ zurückgegeben. Erfahren Sie mehr darüber, wie Sie durch Ergebnisse paginieren.
⌘I