Bonnes pratiques

Ne jamais débiter deux fois

Après une coupure réseau, vous ne savez pas si votre envoi est arrivé. Renvoyez-le avec la même Idempotency-Key (par exemple l'identifiant de la commande) : s'il était arrivé, vous recevez le même message, sans nouveau débit.

Codes à usage unique

Envoyez-les avec "sensitive": true : leur texte est effacé dès l'envoi et n'est jamais conservé. Ne les planifiez pas.

Nouveaux essais

• 5xx ou délai dépassé : réessayez avec la même Idempotency-Key, en espaçant les essais (1 s, 5 s, 30 s).
• 4xx : ne réessayez pas tel quel ; corrigez la requête (voir Erreurs).

Sécurité

• Clé d'API côté serveur uniquement ; jamais dans une application mobile ni dans une page web.
• Deux clés actives au plus : utilisez la seconde pour changer de clé sans coupure.
• Les numéros sont masqués dans toutes les réponses : stockez vous-même la correspondance si vous en avez besoin.

SMS autorisés

L'API sert aux SMS transactionnels : codes, confirmations, rappels, alertes liés à un service que le destinataire utilise. La prospection commerciale et les messages non sollicités sont interdits par les conditions d'utilisation.

Texte

160 caractères en alphabet GSM, 70 seulement dès qu'un caractère en sort (ê, ô, ç, °, ’, emoji). Préférez un texte court et clair, sans ces caractères quand c'est possible, avec le nom de votre entreprise s'il n'apparaît pas dans l'expéditeur.