Choisissez votre parcours d'intégration

Quatre façons d'appeler Quravin — page web simple, React SPA, serveur Node.js, ou API brute sans SDK. Choisissez celle qui correspond à votre stack.

Chaque parcours ci-dessous finit par appeler la même API. La différence réside dans où votre code s’exécute et ce qui existe déjà dans votre stack — choisissez en fonction de cela, pas de ce qui paraît le plus avancé.

Lequel est le vôtre ?

Votre situation	Guide
Une page HTML simple (générée côté serveur, statique, ou une balise `<script>` déposée sur n’importe quel site) — aucune étape de build, aucun framework	Intégration directe d’une page web simple
Une application React monopage — vous voulez que le SDK soit intégré à l’état des composants, pas à une balise script brute	Intégration React SPA
Un backend Node.js — création de session tokens pour un frontend navigateur, ou appel direct de l’API depuis du code serveur uniquement (un cron job, un gestionnaire de webhook, un CLI)	Intégration serveur Node.js
Tout autre langage, ou vous préférez ne pas ajouter de dépendance — vous voulez simplement les requêtes HTTP exactes	Intégration directe de l’API

Avant l’un de ces parcours

Il vous faut d’abord des identifiants — voir Obtenez votre clé API. Chaque parcours ci-dessus nécessite soit une paire client_id/client_secret (pour créer des session JWT), soit une x-api-key statique ; Choisissez votre mode d’authentification explique laquelle convient selon où votre code s’exécute.

La version courte, si vous êtes pressé

Code navigateur (page web ou React) → session JWT, créé par votre propre backend. Ne mettez jamais une x-api-key statique dans du code livré à un navigateur.
Code serveur uniquement (backend Node.js, cron job, service interne) → les deux modes fonctionnent ; une x-api-key statique est plus simple si vous n’avez pas besoin d’attribution par utilisateur.
Aucun SDK du tout → le guide Intégration directe de l’API fonctionne depuis n’importe quel langage, avec les deux modes d’authentification montrés sous forme d’exemples curl simples.