Vos messages sur le téléphone de vos clients, en quelques secondes

Envoi unitaire, puis envoi en masse.

import requests

base = 'https://app.sparrowmessage.com/api/v1'

# — Authentification
jeton = requests.post(f'{base}/login', json={
    'email': '[email protected]',
    'password': 'votre-mot-de-passe',
}).json()['api_token']

entetes = {'Authorization': f'Bearer {jeton}', 'Accept': 'application/json'}

# — Envoi d'un SMS
r = requests.post(f'{base}/sms/send/one', headers=entetes, json={
    'phone':     '+2126XXXXXXXX',
    'text':      'Votre code de vérification est 385 214.',
    'notifyurl': 'https://votre-site.ma/sparrow/statut',
}).json()

print('SMS envoyé' if r['code'] == 'OK' else f"Échec : {r['error']}")

# — Envoi en masse : une seule requête, plusieurs destinataires
requests.post(f'{base}/sms/send/bulk', headers=entetes, json={
    'phones': ['+2126XXXXXXXX', '+2126YYYYYYYY'],
    'text':   'Soldes : -20 % jusqu\'à dimanche. STOP au 36000',
})

# — Statut d'un envoi, à partir de l'identifiant renvoyé
statut = requests.post(f'{base}/sms/status', headers=entetes, json={
    'message_id': '8f21c4',
}).json()
print(statut['result'])

Node 18 ou plus récent : fetch est natif.

const base = 'https://app.sparrowmessage.com/api/v1';

// — Authentification
const { api_token } = await fetch(`${base}/login`, {
  method:  'POST',
  headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
  body:    JSON.stringify({
    email:    '[email protected]',
    password: 'votre-mot-de-passe',
  }),
}).then(r => r.json());

const entetes = {
  'Content-Type': 'application/json',
  Accept:         'application/json',
  Authorization: `Bearer ${api_token}`,
};

// — Envoi d'un SMS
const reponse = await fetch(`${base}/sms/send/one`, {
  method:  'POST',
  headers: entetes,
  body: JSON.stringify({
    phone:     '+2126XXXXXXXX',
    text:      'Votre code de vérification est 385 214.',
    notifyurl: 'https://votre-site.ma/sparrow/statut',
  }),
}).then(r => r.json());

console.log(reponse.code === 'OK' ? 'SMS envoyé' : `Échec : ${reponse.error}`);

// — Envoi en masse
await fetch(`${base}/sms/send/bulk`, {
  method:  'POST',
  headers: entetes,
  body: JSON.stringify({
    phones: ['+2126XXXXXXXX', '+2126YYYYYYYY'],
    text:   'Soldes : -20 % jusqu\'à dimanche. STOP au 36000',
  }),
});

.NET 6 ou plus récent.

using System.Net.Http.Json;

var http = new HttpClient { BaseAddress = new Uri("https://app.sparrowmessage.com/api/v1/") };

// — Authentification
var auth = await http.PostAsJsonAsync("login", new {
    email    = "[email protected]",
    password = "votre-mot-de-passe",
});
var jeton = (await auth.Content.ReadFromJsonAsync<Dictionary<string, string>>())["api_token"];
http.DefaultRequestHeaders.Authorization = new("Bearer", jeton);

// — Envoi d'un SMS
var envoi = await http.PostAsJsonAsync("sms/send/one", new {
    phone     = "+2126XXXXXXXX",
    text      = "Votre code de vérification est 385 214.",
    notifyurl = "https://votre-site.ma/sparrow/statut",
});

var resultat = await envoi.Content.ReadFromJsonAsync<Dictionary<string, object>>();
Console.WriteLine(resultat["code"].ToString() == "OK" ? "SMS envoyé" : $"Échec : {resultat["error"]}");

// — Envoi en masse
await http.PostAsJsonAsync("sms/send/bulk", new {
    phones = new[] { "+2126XXXXXXXX", "+2126YYYYYYYY" },
    text   = "Soldes : -20 % jusqu'à dimanche. STOP au 36000",
});

Java 11 ou plus récent, client HTTP natif.

import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var base   = "https://app.sparrowmessage.com/api/v1";

// — Authentification
var auth = HttpRequest.newBuilder(URI.create(base + "/login"))
    .header("Content-Type", "application/json")
    .header("Accept", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("""
        {"email":"[email protected]","password":"votre-mot-de-passe"}"""))
    .build();

var jeton = extraire(client.send(auth, HttpResponse.BodyHandlers.ofString()).body(), "api_token");

// — Envoi d'un SMS
var envoi = HttpRequest.newBuilder(URI.create(base + "/sms/send/one"))
    .header("Content-Type", "application/json")
    .header("Accept", "application/json")
    .header("Authorization", "Bearer " + jeton)
    .POST(HttpRequest.BodyPublishers.ofString("""
        {"phone":"+2126XXXXXXXX",
         "text":"Votre code de vérification est 385 214.",
         "notifyurl":"https://votre-site.ma/sparrow/statut"}"""))
    .build();

System.out.println(client.send(envoi, HttpResponse.BodyHandlers.ofString()).body());

À copier tel quel dans un terminal.

# — 1. Obtenir le jeton
curl -X POST https://app.sparrowmessage.com/api/v1/login \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -d '{"email":"[email protected]","password":"votre-mot-de-passe"}'

# Réponse : {"code":"OK","api_token":"eyJ0eXAiOiJKV1Qi..."}

# — 2. Envoyer un SMS
curl -X POST https://app.sparrowmessage.com/api/v1/sms/send/one \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $JETON" \
     -d '{"phone":"+2126XXXXXXXX",
          "text":"Votre code de vérification est 385 214.",
          "notifyurl":"https://votre-site.ma/sparrow/statut"}'

# — 3. Envoyer en masse
curl -X POST https://app.sparrowmessage.com/api/v1/sms/send/bulk \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $JETON" \
     -d '{"phones":["+2126XXXXXXXX","+2126YYYYYYYY"],
          "text":"Rappel : votre rendez-vous est demain a 14h30."}'

# — 4. Statut d'un envoi
curl -X POST https://app.sparrowmessage.com/api/v1/sms/status \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $JETON" \
     -d '{"message_id":"8f21c4"}'

# — 5. Statut d'une liste
curl -X POST https://app.sparrowmessage.com/api/v1/sms/status/bulk \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $JETON" \
     -d '{"messages_id":["8f21c4","8f21c5"]}'