Skip to main content
Aucun paramètre.

Les deux champs

sms_count vaut "ND" par conception, pas par omission. Jasmin rapporte un quota de messages prépayés ; FireFlo n’a pas un tel compteur, parce que le crédit est de l’argent et le nombre de messages qu’il achète dépend de leur destination.Plutôt que d’inventer un nombre, le champ dit qu’il n’est pas déterminé.

Quel compte

Celui que le login facture — app_credential.account_id, pas le nom du login. Plusieurs logins sur un même compte rapportent tous le même solde, et dépensent tous le même crédit.

Un solde positif peut quand même refuser un message

Le crédit est réservé en blocs — max(smsg.balance.block.min, price × smsg.balance.block.min.messages), l’équivalent de vingt messages par défaut — et les recharges sont asynchrones.Donc un message qui arrive pendant que la réservation suivante est prise obtient 402 alors même que cet endpoint rapporte un solde positif. C’est transitoire ; le retry réussit.La taille de bloc ne piège pas le crédit : une réservation retombe sur le bloc, le plancher, puis finalement sur le message unique qui l’a demandée. Un compte dépense donc chaque unité qu’il détient.

Ne sondez pas cet endpoint par message

C’est une lecture en base, cela ne vous dit rien quant à l’acceptation de ce message précis, et cela double votre volume de requêtes. Sondez-le périodiquement pour l’alerting, et laissez un 402 être votre signal par message.

Décimales

balance est affiché avec smsg.money.scale décimales — 0 à 4, 4 par défaut. L’Inde utilise 2. Le stockage ne change jamais : les montants sont des entiers de dix-millièmes. Ceci n’est qu’une présentation. Les tarifs sur /secure/rate conservent toujours quatre décimales quoi qu’il arrive, parce qu’un tarif affiché 0.05 au lieu de 0.0450 s’écarte de 11% sur chaque message.

Erreurs

Uniquement les erreurs partagées. Voir Erreurs de l’API.

Voir aussi

Solde et devis

Utiliser ceci en parallèle de /secure/rate.

Crédit prépayé

Le côté opérateur : blocs, ledger et l’identité de l’argent.