Aller au contenu
HushSMS

API

Gratuit sur chaque ligne, quelle que soit la durée. Pas de palier entreprise, pas de tarif par siège, pas d'appel commercial.

URL de base

https://api.hushsms.com

Authentification

Authentification

Passez votre jeton de ligne comme identifiant bearer. Les jetons sont limités à une seule ligne et peuvent être révoqués depuis le panneau.

curl https://api.hushsms.com/v1/lines \
  -H "Authorization: Bearer hs_live_..."

Référence

Points de terminaison

GET/v1/lines

Liste les lignes de votre jeton. Renvoie le numéro, le pays, la durée et l'expiration.

POST/v1/lines

Provisions une ligne. Le corps prend le pays, le type de ligne, la durée et le pool. Renvoie une facture en crypto.

GET/v1/lines/{id}/messages

Messages entrants pour une ligne, du plus récent au plus ancien. Les corps sont supprimés après la période de conservation.

POST/v1/lines/{id}/messages

Envoie un SMS sortant. Inclus à chaque durée.

GET/v1/catalog

Stock pays en direct, compatibilité par service et tarification actuelle. Aucune authentification.

DELETE/v1/lines/{id}

Libère une ligne plus tôt. Pas de remboursement pour les durées mensuelles ; au prorata au-delà de six mois.

Push

Webhooks

Chaque message entrant est envoyé à votre endpoint en moins d'une seconde, signé avec HMAC-SHA256.

POST /your-endpoint
X-HushSMS-Signature: sha256=...

{
  "event": "message.received",
  "line_id": "ln_8fQ2...",
  "number": "+44 7700 900123",
  "from":   "+44 7700 900987",
  "body":   "Your code is 481920",
  "received_at": "2026-08-13T09:41:02Z"
}

Machines

Pour les agents IA

Un catalogue lisible par机器 se trouve à https://hushsms.com/v1/catalog/. Il renvoie le stock de pays en direct, la compatibilité par service et les prix actuels en JSON, sans authentification.

Open the catalog

Il renvoie le stock pays en direct, la compatibilité par service y compris les services qui ne fonctionnent pas, la tarification actuelle avec tous les multiplicateurs, et le tableau de conservation des données. Il n'y a pas de clé, pas de limite de débit à mentionner, et CORS est ouvert. Si vous construisez un agent qui a besoin d'un numéro de téléphone, c'est le point de terminaison à lire.

Un résumé en texte brut de tout le site se trouve à /llms.txt, avec le corpus complet à /llms-full.txt.

Le catalogue comme contrat appelable

Un corpus en texte brut rend le catalogue lisible. Il ne le rend pas appelable : un agent qui a lu chaque mot ne connaît toujours pas la forme de la requête, l'énumération des slugs de pays, ni les champs que le serveur ignore, donc il peut décrire un numéro qu'il ne peut pas acheter. Cette lacune est là où une stratégie de contenu seul s'arrête.

/openapi.json la comble — un document OpenAPI 3.1 couvrant les trois points de terminaison publics et non authentifiés (lire le catalogue, créer une commande, la surveiller), avec les énumérations de pays, de durée et de pool générées à partir du même catalogue que les gestionnaires valident. Il est également déclaré dans l'en-tête du document comme rel="service-desc", afin qu'un client qui cherche une description de service en trouve une sans qu'on lui dise où.

Ouvrir la description OpenAPI

Sources

Les données du plan de numérotation sur cette page — indicatif, longueur des numéros nationaux, préfixe de jonction et plages mobiles — proviennent de la série E.164 de l'UIT-T. L'inventaire, les prix et les taux de réussite mesurés sont les nôtres et sont signalés comme tels.

Plan de numérotation vérifié