- Nützliche Tools
- Zentrale Konzepte
Anleitungen
Leitfaden zur Integration
Diese Seite enthält Informationen zu mehreren Tools und wichtigen Konzepten, die Sie kennen sollten, wenn Sie die Endpunkte zum Verwalten von Lesezeichen in Ihr System integrieren. Wir haben die Seite in mehrere Abschnitte unterteilt:
Bevor wir auf einige Schlüsselkonzepte eingehen, die Ihnen bei der Integration dieses endpoint helfen, empfehlen wir, sich mit Folgendem vertraut zu machen:
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 verstehen, was Ihnen zur Verfügung steht. Um mehr über unsere Postman-Collections zu erfahren, besuchen Sie bitte unsere Seite “Using Postman”.
Möchten Sie dieses endpoint in Ihrer bevorzugten Programmiersprache einrichten? Auf unserer GitHub-Seite finden Sie mehrere Codebeispiele, die Sie als Ausgangspunkt nutzen können.
Nutzen Sie eine der Bibliotheken von Drittanbietern aus unseren Communities, um den Einstieg zu erleichtern. Sie finden eine Bibliothek, die mit den v2 endpoints funktioniert, indem Sie nach dem entsprechenden Versions-Tag suchen.
Alle X API v2 Endpoints erfordern, dass Sie Ihre Anfragen mit einem Satz von Anmeldeinformationen authentifizieren, auch bekannt als Keys und Tokens.
Diese spezifischen Endpoints erfordern die Verwendung des OAuth 2.0 Authorization Code Flow with PKCE. Das bedeutet, dass Sie einen Satz von 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 Auftrag Sie die Anfrage stellen. Wenn Sie einen Satz von Access Tokens für einen anderen Benutzer generieren möchten, muss dieser Ihre App über eine Authorize URL autorisieren oder authentifizieren.
Bitte beachten Sie, dass OAuth 2.0 komplex sein kann. Wenn Sie mit dieser Authentifizierungsmethode nicht vertraut sind, empfehlen wir, eine Library oder ein Tool wie Postman zu verwenden, um Ihre Anfragen ordnungsgemäß zu authentifizieren.
Um Authentifizierungsdaten zu erhalten, die mit den X API v2 endpoints funktionieren, müssen Sie ein Developer-Konto besitzen, 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.
Jeden Tag senden viele Tausend Entwickler Anfragen an die X API. Um das enorme 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.
Diese endpoints sind auf Nutzerebene rate limited. Das bedeutet, dass der authentifizierte Nutzer, in dessen Namen Sie die Anfrage stellen, das endpoint über jede Developer-App hinweg nur eine bestimmte Anzahl von Malen aufrufen kann. Es gibt ein User-Rate Limit von 180 Anfragen pro 15-Minuten-Fenster für die GET-Methode. Mit der GET-Methode des Bookmarks Lookup-endpoints erhalten Sie bis zu 800 Ihrer neuesten mit Lesezeichen versehenen Posts. Zusätzlich gibt es ein User-Rate Limit von 50 Anfragen pro 15 Minuten für die Methoden POST und DELETE.
⌘I