Référence API
Identifiants d’expéditeur
Les noms et numéros depuis lesquels votre compte peut envoyer.
Vérifiez is_sendable, jamais status
Un expéditeur peut être APPROVED par SMSend sans être enregistré auprès du moindre opérateur, auquel cas il ne peut porter aucun trafic. Un envoi avec lui réussit à la soumission puis échoue sur chaque message individuel, après que chacun a consommé la totalité de son budget de tentatives. L’indicateur is_sendable combine déjà les deux conditions — ne le reconstruisez pas à partir de status.
Lister les identifiants d’expéditeur
GET
/public/v1/sender-idsRenvoie tous les expéditeurs enregistrés sur le compte, triés par valeur, en indiquant lesquels sont actuellement utilisables.
Portée requise SENDER_IDS_READ
Requête
Réponses
200Les identifiants d’expéditeur du compte.
Erreurs possibles
| Code | Statut | Signification |
|---|---|---|
UNAUTHORIZED | 401 | Aucune clé, une clé malformée, un mauvais secret, une clé révoquée ou expirée, ou un compte suspendu. Tous indiscernables par construction. |
INSUFFICIENT_SCOPE | 403 | La clé est valide mais ne porte pas la portée exigée par ce point de terminaison. La portée est nommée dans le detail. |
RATE_LIMITED | 429 | La limite de requêtes de la clé a été dépassée. Attendez l’intervalle indiqué dans Retry-After. |
INTERNAL_ERROR | 500 | Une défaillance inattendue du côté de SMSend. Citez l’identifiant de requête à l’assistance. |
Statuts
| Valeur | Signification |
|---|---|
PENDING | Soumis et en attente d’examen. |
APPROVED | Approuvé par SMSend. Doit encore être enregistré auprès d’un opérateur avant de pouvoir envoyer. |
REJECTED | Refusé lors de l’examen. Le champ reason explique pourquoi. |
REVOKED | Retiré après avoir été approuvé. |
Types
Le type est déduit de la valeur plutôt que déclaré lors de l’enregistrement de l’expéditeur.
| Valeur | Signification |
|---|---|
ALPHANUMERIC | Contient des caractères non numériques — un nom de marque comme PRESTIGE. Les destinataires ne peuvent pas y répondre. |
NUMERIC | Un numéro long, de huit chiffres ou plus. Peut recevoir des réponses. |
SHORT_CODE | Un numéro court, de moins de huit chiffres. |