Guide développeur
SDKs officiels
@qyvn/node— Node.js / TypeScriptqyvn-python— Python 3.9+qyvn-go— Go 1.21+
Installation
npm install @qyvn/node
import { Qyvn } from "@qyvn/node";
const qyvn = new Qyvn({ apiKey: process.env.QYVN_API_KEY });
const txns = await qyvn.transactions.list({
entity: "ent_9f2a",
date_gte: "2025-01-01",
});
Environnements
| Env | URL | Usage |
|---|---|---|
| Production | api.qyvn.io | Données réelles |
| Sandbox | sandbox.qyvn.io | Tests, données fictives |
Bonnes pratiques
- Utilisez des clés dédiées par service, pas partagées
- Idempotence : passez
Idempotency-Keysur toute création - Retry avec backoff exponentiel sur
429et5xx - Signez et vérifiez les webhooks (voir Webhooks)
- Limitez les scopes au strict nécessaire