Schnellstart für Entwickler
Die zwei Wege, deine Readsira-Bibliothek aus Code zu nutzen, REST API v2 und der MCP-Server, und wo du anfängst.
Schlüssel, Scopes und Limits
Wie du dich bei der Readsira-API authentifizierst, welche Scopes es gibt und welche Limits pro Tarif gelten.
Authentifizierung und API-Schlüssel
Erstelle einen API-Schlüssel, sende ihn mit einer Anfrage, wähle die nötigen Scopes und bewahre ihn sicher auf.
Ratenlimits und Fehler
Wie die REST-API Anfragen begrenzt, welche Header sie sendet, wie ein Fehler aufgebaut ist und was jeder Fehlercode bedeutet.
Paginierung
Wie du lange Ergebnisse Seite für Seite mit Offsets, Cursorn und Seitennummern liest.
Webhooks für Entwickler
Die Ereignisse, die Readsira an deinen Server sendet, die Payload jedes Ereignisses, wie du die Signatur in Node prüfst und wie Zustellungen wiederholt werden.
Beispiele
Vier funktionierende Beispiele mit curl und Node 18 oder neuer, die einen Link speichern, die Markierungen eines gespeicherten Eintrags lesen, eine Frage mit Quellenangaben stellen und deine Bibliothek in eine Datei synchronisieren.
REST-API-v2-Referenz
Jede Route der Readsira REST API v2: Parameter, Request-Bodys, Antworten und Fehler, direkt aus der API erzeugt.