Documentation API SMS

Authentification

Utilisez votre clé API dans l'en-tête des requêtes : Authorization: Bearer VOTRE_CLE_API

Votre clé API actuelle

Aucun token disponible

Envoi de SMS

Paramètres

Champ	Type	Description
recipients	Array[String]	Liste de numéros de téléphone internationaux au format E.164 (ex: +22670123456). Chaque numéro doit inclure le code pays et ne doit pas contenir d'espaces ou de caractères spéciaux autres que le signe plus (+).
message	String	Contenu du message. Le message ne doit pas dépasser les 160 caractères; au cas où cela dépasse, le SMS sera segmenté pour être envoyé. Mais c'est considéré que le nombre de segments est égal au nombre de messages.
senderId	String	Identifiant de l'expéditeur. Le senderId doit correspondre à celle créée dans la gestion des IDs. À l'exception, on utilisera le nom de l'utilisateur pour l'envoi (mais pas plus de 11 caractères).
scheduledTime	String	Date et heure de programmation (ISO 8601, optionnel). Si elle n'est pas fournie, le SMS sera envoyé immédiatement.

Exemples de code

cURL

PHP

Python

Node.js

Java

            
                curl -X POST \
                -H "Authorization: Bearer VOTRE_CLE_API" \
                -H "Content-Type: application/json" \
                -d '{"recipient":"+22670123456","message":"Votre message"}' \
                https://api.alliance-sms.com/v1/sms/send


$client = new \GuzzleHttp\Client();
$response = $client->post('https://api.alliance-sms.com/v1/sms/send', [
    'headers' => [
        'Authorization' => 'Bearer VOTRE_CLE_API',
        'Content-Type' => 'application/json'
    ],
    'json' => [
        'recipient' => '+22670123456',
        'message' => 'Votre message'
    ]
]);


import requests

url = "https://api.alliance-sms.com/v1/sms/send"
headers = {
    "Authorization": "Bearer VOTRE_CLE_API",
    "Content-Type": "application/json"
}
data = {
    "recipient": "+22670123456",
    "message": "Votre message"
}

response = requests.post(url, json=data, headers=headers)


const axios = require('axios');

axios.post('https://api.alliance-sms.com/v1/sms/send',
    {
        recipient: '+22670123456',
        message: 'Votre message'
    },
    {
        headers: {
            'Authorization': 'Bearer VOTRE_CLE_API',
            'Content-Type': 'application/json'
        }
    }
);


HttpClient client = HttpClient.newHttpClient();
String json = String.format(
    "{\"recipient\":\"%s\",\"message\":\"%s\"}",
    "+22670123456",
    "Votre message"
);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.alliance-sms.com/v1/sms/send"))
    .header("Authorization", "Bearer VOTRE_CLE_API")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(json))
    .build();

client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
    .thenApply(HttpResponse::body)
    .thenAccept(System.out::println);

Exporter la collection Postman

Instructions

Générez la collection en cliquant sur le bouton ci-dessus après avoir rempli les champs.
Le fichier JSON (alliance_sms_postman_collection.json) sera téléchargé automatiquement.
Ouvrez Postman et importez le fichier JSON via l'option "Import".
Les variables base_url et api_token sont déjà configurées.
Utilisez les requêtes préconfigurées pour interagir avec l'API.

Réponses API


                            {
                                "status": "success",
                                "messageId": "ABC123",
                                "creditsUsed": 1,
                                "timestamp": "2023-10-01T12:00:00Z"
                            }


                            {
                                "status": "error",
                                "code": "INVALID_RECIPIENT",
                                "message": "Numéro invalide"
                            }

Support technique

Contactez notre équipe à
support@alliance-sms.com

Si vous rencontrez des problèmes, veuillez nous contacter et nous vous répondrons dans les plus brefs délais.

Intégration de l'API

Cette section présente les différentes méthodes d'intégration de l'API SMS de Alliance SMS dans vos applications.

Intégration directe

L'API peut être intégrée directement dans votre application en utilisant les exemples de code fournis dans la section précédente. Cette méthode offre un contrôle total sur le processus d'envoi et de réception des SMS.

Support technique

Si vous rencontrez des difficultés lors de l'intégration de notre API, n'hésitez pas à contacter notre équipe de support technique à l'adresse support@alliance-sms.com ou via le chat intégré à notre plateforme.