Documentation développeurs

Votre premier SMS, en trois étapes

Une API REST, une clé, un appel HTTP. L'environnement de test permet de valider l'intégration sans consommer de crédit.

Démarrage

Commencez en trois étapes

1

Créez votre compte

Gratuit, sans carte bancaire. L'environnement de test est actif immédiatement.

2

Générez une clé d'API

Depuis votre tableau de bord. La clé n'est affichée qu'à sa création : nous n'en conservons qu'une empreinte.

3

Envoyez votre premier message

Un POST sur /api/v1/send/ avec le destinataire et le texte du message.

Envoyer un message

Dans votre langage

Le même appel dans quatre langages. Aucune bibliothèque à installer.

curl -X POST https://api.syrahub.com/api/v1/send/ \
  -H "Authorization: Bearer syra_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "22670000000",
    "body": "Votre commande est prête.",
    "sender_id": "SYRAHUB",
    "client_reference": "cmd-4821"
  }'

Avant d'intégrer

Quatre points à connaître

Idempotence par client_reference

Rejouée avec la même référence, une requête renvoie le message existant au lieu d'en créer un second : ni doublon, ni double débit.

Webhooks signés HMAC-SHA256

Les accusés de réception et les messages entrants sont transmis à votre URL, signés. Vérifiez la signature avant traitement.

Facturation au segment

Un SMS compte 160 caractères en alphabet GSM, 70 dès qu'un caractère en sort. La translittération automatique évite le second cas.

Clé d'API et adresses autorisées

La clé est stockée hachée et n'est affichée qu'à sa création. Une liste d'adresses IP autorisées, en notation CIDR, restreint son usage à vos serveurs.

Surface de l'API

Les points d'entrée principaux

Méthode Chemin Usage
POST/api/v1/send/Envoyer un message
POST/api/v1/send/batch/Envoyer un lot, avec pré-vol du coût
GET/api/v1/balance/Connaître le solde du compte
GET/api/v1/messages/Historique, filtrable par référence ou par sens
GET/api/v1/messages/{id}/Statut détaillé d'un message
POST/api/v1/messages/{id}/reply/Répondre à un message entrant

Paramètres, codes d'erreur et schémas complets : référence Swagger.

Capacité

Dimensionné pour vos pics

Relevés sur nos campagnes de charge, en environnement de test.

4 400
SMS par minute

Débit de bout en bout, jusqu'au statut de remise de l'opérateur.

178 ms
Temps de réponse (p95)

Sur 5 336 requêtes à 60 utilisateurs simultanés.

2
Files de traitement

Messages critiques et campagnes de masse traités séparément.

Validez votre intégration avant de vous engager

L'environnement de test simule des remises réelles, sans consommer de crédit.

Obtenir ma clé d'API