Compteur de caractères

Estime un SMS avant envoi : nombre de segments, encodage détecté, prix unitaire et coût total, selon le tarif de votre compte.

URL

POST https://api.smspartner.fr/v1/sms/estimate

Rate limit : 30 requêtes / 30 secondes

Paramètres

Nom	Valeur
apiKey	Votre clé API
text	Obligatoire. Contenu du message à estimer. 10 000 caractères maximum.
country	Optionnel. Code pays ISO 3166-1 alpha-2 (ex : FR, BE) utilisé pour déterminer le tarif. Valeur par défaut : FR.

Un message ne peut pas dépasser 10 SMS (segments). Au-delà, l'API renvoie une erreur.

Exemple de requête

{
    "apiKey": "xxx",
    "text": "Merci pour votre commande livraison prévue demain avant midi !",
    "country": "FR"
}

Réponse

Champ	Valeur
sms_count	Nombre de segments SMS nécessaires pour envoyer le message.
encoding	Encodage détecté : GSM-7 (alphabet standard) ou UCS-2 (caractères Unicode, ex : emojis, accents étendus).
cost_per_sms	Prix unitaire par segment SMS, selon le tarif de votre compte.
total_cost	Coût total estimé (cost_per_sms × sms_count).
is_unicode_required	Présent et à true uniquement lorsque l'encodage est UCS-2 (le message contient des caractères Unicode). Absent sinon.

Réponse (UCS-2)

{
    "sms_count": 2,
    "encoding": "UCS-2",
    "cost_per_sms": 0.038,
    "total_cost": 0.076,
    "is_unicode_required": true
}

Réponse (GSM-7)

{
    "sms_count": 1,
    "encoding": "GSM-7",
    "cost_per_sms": 0.038,
    "total_cost": 0.038
}

Erreurs

En cas d'erreur, la réponse a la forme { "success": false, "message": "..." } avec le statut HTTP correspondant.

Statut HTTP	Cas
400	JSON invalide, paramètre text manquant, text de plus de 10 000 caractères, ou message dépassant 10 SMS.
401	apiKey manquante ou invalide.
429	Limite de débit dépassée (30 requêtes / 30 secondes).