Wählen Sie Ihren Integrationspfad
Vier Wege, Quravin aufzurufen — einfache Webseite, React-SPA, Node.js-Server oder rohe API ohne SDK. Wählen Sie den, der zu Ihrem Stack passt.
Jeder Pfad unten ruft am Ende dieselbe API auf. Der Unterschied liegt darin, wo Ihr Code läuft und was bereits in Ihrem Stack vorhanden ist — wählen Sie danach, nicht danach, was am fortgeschrittensten klingt.
Welcher ist Ihrer?
| Ihre Situation | Anleitung |
|---|---|
Eine einfache HTML-Seite (serverseitig gerendert, statisch, oder ein <script>-Tag, das auf einer beliebigen Seite eingefügt wird) — kein Build-Schritt, kein Framework | Direkte Integration für einfache Webseiten |
| Eine React-Single-Page-App — Sie möchten das SDK in den Komponentenzustand einbinden, kein rohes Script-Tag | React-SPA-Integration |
| Ein Node.js-Backend — Session-Tokens für ein Browser-Frontend erstellen, oder die API direkt aus reinem Server-Code aufrufen (ein Cron-Job, ein Webhook-Handler, eine CLI) | Node.js-Server-Integration |
| Jede andere Sprache, oder Sie möchten lieber keine Abhängigkeit hinzufügen — Sie wollen nur die genauen HTTP-Anfragen | Direkte API-Integration |
Bevor Sie eines davon tun
Sie brauchen zuerst Zugangsdaten — siehe Holen Sie sich Ihren
API-Schlüssel. Jeder Pfad oben benötigt entweder ein
client_id/client_secret-Paar (um Session-JWTs zu erstellen) oder einen statischen x-api-key;
Wählen Sie Ihren Auth-Modus erklärt, welches wohin passt, je
nachdem, wo Ihr Code läuft.
Die Kurzfassung, falls Sie es eilig haben
- Browser-Code (Webseite oder React) → Session-JWT, erstellt von Ihrem eigenen Backend. Setzen
Sie niemals einen statischen
x-api-keyin Code, der an einen Browser ausgeliefert wird. - Reiner Server-Code (Node.js-Backend, Cron-Job, interner Dienst) → beide Modi funktionieren;
ein statischer
x-api-keyist einfacher, wenn Sie keine Zuordnung pro Nutzer benötigen. - Gar kein SDK → die Anleitung Direkte API-Integration
funktioniert in jeder Sprache, mit beiden Auth-Modi als einfache
curl-Beispiele gezeigt.