JavaScript

Intégration JavaScript avec l’API REST et fetch. Le SDK npm public n’est pas encore disponible.

Pré-requis

Utilisez fetch côté serveur.
Conservez la clé API dans l’environnement du serveur, jamais dans un bundle public.
Aucune dépendance Coussema à installer.

Envoi SMS

javascript

import crypto from 'node:crypto';

const baseUrl = process.env.COUSSEMA_BASE_URL ?? 'https://api.coussema.com';
const apiKey = process.env.COUSSEMA_API_KEY ?? '';
const response = await fetch(`${baseUrl}/v1/sms/send`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
    'X-Request-Id': 'javascript-rest-send-001',
  },
  body: JSON.stringify({
    to: '243810000000',
    message: 'Votre code est 482019',
    senderName: 'COUSSEMA',
  }),
});

const result = await response.json();
if (!response.ok) throw new Error(`SMS request failed: ${response.status}`);

console.log({
  queued: result.queued,
  status: result.status,
  messageId: result.message.id,
  remainingQuota: result.remainingQuota,
});

Réponse 202

queued: true et status: accepted indiquent la mise en file. Conservez message.id; provider.messageId reste null. Suivez la livraison par webhook ou DLR.

Démarrage rapideContrat APIExemples RESTOpenAPIWebhooks

← Exemples Python →