Où est la documentation ?

La référence OpenAPI est publique (/v1/openapi.json) et votre espace développeur contient des exemples prêts à copier.

Quels pays sont couverts ?

La France métropolitaine, l'outre-mer (La Réunion, Mayotte, Guadeloupe, Martinique, Guyane) et le Luxembourg, avec le même compte et le même solde. Chaque SMS est facturé au prix de son territoire.

Que se passe-t-il si un SMS n'est pas remis ?

Le statut final vous est envoyé par webhook et reste visible dans l'historique. Les SMS refusés avant l'envoi (numéro désinscrit ou invalide) ne sont pas facturés.

Les SMS de votre logiciel, sans y passer la semaine.

Une API REST simple, des clés de test pour développer sans rien envoyer, des webhooks signés pour suivre chaque message. Facturé à l'usage, en euros.

Créer un compte — 10 SMS offerts Parler à un conseiller

curl https://ruedusms.com/v1/sms \
  -H "Authorization: Bearer rds_test_…" \
  -H "Idempotency-Key: rdv-4512" \
  -d '{"to":"06 12 34 56 78","sender":"GARAGE24",
       "text":"RDV confirmé demain 14h."}'

→ 201 {"id":"test_…","status":"test","segments":1,
       "price":"0.065","currency":"EUR","test":true}

Ce que l’API fait pour vous

Envoi

Un appel, un SMS

Le numéro peut être transmis tel que l'utilisateur l'a saisi : il est normalisé et contrôlé (mobile, pays) avant l'envoi.

Fiabilité

Idempotence

Avec une clé d'idempotence, une nouvelle tentative après une coupure réseau ne crée pas de doublon : le SMS part et n'est facturé qu'une fois.

Suivi

Webhooks signés

Statuts de remise, désinscriptions STOP et réponses arrivent sur votre URL, signés pour que vous puissiez vérifier leur origine.

Développement

Clés de test

Une clé de test valide la requête comme en production, sans rien envoyer ni facturer.

Comment ça se passe

1
Créez un compte
10 SMS offerts et clés de test disponibles immédiatement dans l'espace développeur.
2
Intégrez
Référence OpenAPI publique, exemples prêts à copier, réponses d'erreur explicites.
3
Passez en production
Nom d'expéditeur validé, solde rechargé par virement ou par carte, et c'est parti.

Inclus, sans option

Référence OpenAPI (/v1/openapi.json)
Normalisation et contrôle des numéros France et Luxembourg
Idempotence et webhooks signés
Liens raccourcis et suivi des clics en option
Plusieurs clés et utilisateurs par compte

Les règles opérateurs, gérées par la plateforme

Mention STOP, horaires des SMS publicitaires, liste d'opposition : l'API applique les mêmes contrôles que l'interface. Un SMS publicitaire demandé à 23h est décalé au lendemain 8h, et un numéro désinscrit n'est jamais facturé.

Questions fréquentes

Où est la documentation ?: La référence OpenAPI est publique (/v1/openapi.json) et votre espace développeur contient des exemples prêts à copier.
Quels pays sont couverts ?: La France métropolitaine, l'outre-mer (La Réunion, Mayotte, Guadeloupe, Martinique, Guyane) et le Luxembourg, avec le même compte et le même solde. Chaque SMS est facturé au prix de son territoire.
Que se passe-t-il si un SMS n'est pas remis ?: Le statut final vous est envoyé par webhook et reste visible dans l'historique. Les SMS refusés avant l'envoi (numéro désinscrit ou invalide) ne sont pas facturés.

On en parle ?

Créez un compte pour tester avec 10 SMS offerts, ou décrivez votre besoin : un conseiller vous répond sous un jour ouvré.

Créer un compte — 10 SMS offerts Parler à un conseiller