Integrationsleitfaden

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

• Nützliche Tools
• Zentrale Konzepte
• Authentifizierung
• Entwicklerportal, Projects und Apps
• Rate Limits

​

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 erfassen, welche Möglichkeiten Ihnen zur Verfügung stehen. Weitere Informationen zu unseren Postman-Collections finden Sie auf unserer Seite “Using Postman”. 

​

Codebeispiele

Möchten Sie dieses endpoint 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 funktionieren, indem Sie nach dem entsprechenden 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. 

Diese 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 Nutzer zugeordnet sein, in dessen Namen Sie die Anfrage stellen. Wenn Sie einen Satz von Access Tokens für einen anderen Nutzer generieren möchten, muss dieser Ihre App über den 3-legged OAuth-Flow autorisieren bzw. authentifizieren.

Bitte beachten Sie, dass OAuth 1.0a in der Anwendung anspruchsvoll sein kann. Wenn Sie mit dieser Authentifizierungsmethode nicht vertraut sind, empfehlen wir, eine library oder ein Tool wie Postman zu verwenden, um Ihre Anfragen korrekt zu authentifizieren.  

​

Entwicklerportal, Projects und Developer-Apps

Um einen Satz an Authentifizierungsdaten zu erhalten, der mit den X API v2 endpoints funktioniert, müssen Sie sich für ein Developer-Konto anmelden, ein Project in diesem Konto einrichten und eine Developer-App in diesem Project 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 Anfrageaufkommen zu verwalten, 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. 

Diese endpoints sind auf Nutzerebene ratebegrenzt. Das bedeutet, dass der authentifizierte Nutzer, in dessen Namen Sie die Anfrage stellen, das endpoint nur eine bestimmte Anzahl von Malen über jede Developer-App aufrufen kann. 

Die folgende Tabelle zeigt die Rate Limits für jedes endpoint.

Endpoint	HTTP-Methode	Rate Limit
/2/lists	POST	300 requests per 15 minutes
/2/lists/:id	DELETE / PUT	300 requests per 15 minutes