Retour aux docs APIOfficial SDK

SDK JavaScript officiel

Le SDK publie le contrat public en code exploitable pour vos backends Node, workers et intégrations internes. Il suit le même schéma que l’API publique et évite la dérive manuelle de payloads.

Ce qu’il couvre

Client typé généré depuis le contrat OpenAPI 3.1 partagé.
Support des headers `Authorization`, `Idempotency-Key` et `X-Request-Id`.
Helpers de validation de signature pour les webhooks Coussema.
Compatible Node.js pour les backends, workers et jobs planifiés.
Installation

npm install

npm install @coussema/sdk-js
import crypto from 'node:crypto';
import { CoussemaClient } from '@coussema/sdk-js';

const client = new CoussemaClient({
  baseUrl: process.env.COUSSEMA_BASE_URL ?? 'https://api.coussema.com',
  apiKey: process.env.COUSSEMA_API_KEY ?? '',
});

const result = await client.sendSms(
  {
    to: '243810000000',
    message: 'Votre code est 482019',
    senderName: 'COUSSEMA',
  },
  {
    idempotencyKey: crypto.randomUUID(),
    requestId: 'sdk-page-send-001',
  }
);

console.log(result.data.remainingQuota);

Quand l’utiliser

  • Backends Node.js qui orchestrent envoi SMS et gestion des contacts.
  • Workers ou crons qui doivent relancer une mutation idempotente.
  • Serveurs webhook qui doivent vérifier la signature Coussema.

Source de vérité

Le SDK est généré depuis le contrat OpenAPI exposé par la plateforme. Quand un nouvel endpoint public devient stable, la génération du SDK suit le même schéma partagé sans divergence manuelle.