Aller au contenu
Aureus PrimeDocs

Référence API

Historique des versions

Les évolutions de l'API SMS, de la plus récente à la plus ancienne. Un changement incompatible (champ retiré, comportement modifié) est toujours signalé comme tel ici, avant sa mise en service.

2 novembre 2026

Nouveau :

  • message en 2 SMS avec "allowTwoParts": true : jusqu'à environ 310 caractères, découpés entre deux mots, préfixes « 1/2 » et « 2/2 », facturés par partie ; la partie 2 ne part qu'une fois la partie 1 livrée (errorCode PART1_NOT_DELIVERED si elle ne l'est pas sous 15 minutes) ;
  • champs groupId et part dans l'objet message ; normalized, smsCount, totalCredits et parts dans la réponse d'envoi ;
  • GET /sms/balance renvoie les crédits offerts (promoBalance, promoExpiresAt) ;
  • GET /sms/coverage documentée : pays ouverts et prix d'un SMS en crédits.

Changements de comportement :

  • le texte est toujours converti dans l'alphabet des SMS (ê devient e, l'apostrophe courbe devient droite, emoji et alphabets non latins retirés). Le mode Unicode limité à 70 caractères n'existe plus : 160 caractères par SMS dans tous les cas ;
  • un texte de plus de 160 caractères répond désormais 422 TEXT_TWO_PARTS_REQUIRED (au lieu de TEXT_TOO_LONG), et 422 TEXT_TWO_PARTS_MAX au-delà de 2 SMS ;
  • solde en crédits : 1 crédit = 1 FCFA, 25 crédits par SMS au Cameroun, bonus de crédits sur les grandes recharges ;
  • un seul nom d'expéditeur personnalisé par compte : 409 SENDER_LIMIT_REACHED et 409 SENDER_NAME_REFUSED remplacent 409 CONFLICT.

1er novembre 2026 — première version publique

L'API SMS d'Aureus Desk est ouverte, en version v1.

Disponible :

  • envoi de SMS vers les mobiles MTN et Orange du Cameroun (POST /sms/messages), avec clé d'idempotence et messages sensibles ;
  • envoi planifié jusqu'à 30 jours à l'avance (scheduledAt) et annulation d'un SMS planifié (DELETE /sms/messages/:id) ;
  • suivi de la livraison (GET /sms/messages/:id) ;
  • solde, grille de prix et expéditeurs (GET /sms/balance, GET /sms/price-tiers, GET et POST /sms/senders) ;
  • longueur d'un SMS selon l'encodage : 160 caractères en alphabet GSM, 70 en Unicode ;
  • limitation de débit par clé, avec le code 429 RATE_LIMITED ;
  • 2 clés d'API actives au plus par compte.

Pas encore disponible : environnement de test, notifications de livraison par webhook.