Documentation

API Reference

Envoyez des SMS depuis n'importe quelle application en quelques lignes de code.

Base URL

https://api.smsaas.fr

Authentification

Toutes les requêtes API doivent inclure votre clé API dans l'en-tête Authorization. Récupérez votre clé depuis votre dashboard.

En-tête HTTP
Authorization: Bearer sms_votre_clé_api
POST

Envoyer un SMS

/api/sms/send

Corps de la requête

ParamètreTypeRequisDescription
tostringOuiNuméro au format international (ex: +33612345678)
messagestringOuiContenu du SMS (160 caractères max)

Requête

curl
curl -X POST https://api.smsaas.fr/api/sms/send \
  -H "Authorization: Bearer sms_votre_clé_api" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+33612345678",
    "message": "Bonjour depuis SMS Express !"
  }'

Réponse — 200 OK

200 OK
{
  "success": true,
  "message": "SMS envoyé avec succès",
  "credits_remaining": 99
}

Codes d'erreur

401

Clé API manquante ou invalide

Vérifiez votre en-tête Authorization.

402

Crédits insuffisants

Rechargez votre compte depuis le dashboard.

422

Paramètres invalides

Les champs "to" et "message" sont requis. Message max 160 caractères.

500

Erreur serveur

Une erreur interne est survenue. Réessayez.

Exemples

Python
import requests

response = requests.post(
    "https://api.smsaas.fr/api/sms/send",
    headers={
        "Authorization": "Bearer sms_votre_clé_api",
        "Content-Type": "application/json",
    },
    json={
        "to": "+33612345678",
        "message": "Bonjour depuis SMS Express !",
    }
)
print(response.json())
Node.js
const res = await fetch('https://api.smsaas.fr/api/sms/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sms_votre_clé_api',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    to: '+33612345678',
    message: 'Bonjour depuis SMS Express !',
  }),
});
const data = await res.json();
console.log(data);
PHP
$ch = curl_init('https://api.smsaas.fr/api/sms/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer sms_votre_clé_api',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'to' => '+33612345678',
    'message' => 'Bonjour depuis SMS Express !',
]));
$response = json_decode(curl_exec($ch), true);