NAV
cURL PHP JavaScript C Python Ruby

Introduction

Bienvenue sur SuperCool SMS Développeur!
Nous mettons à votre disposition notre API pour vous permettre d'interagir avec notre plateforme depuis vos applications métiers. Vous pouvez utiliser notre API pour envoyer des SMS unitaires, faire des campagnes ou consulter votre solde de crédit.

La logique derrière notre API est simple. Avant d'effectuer n'importe quelle opération, il faut que l'utilisateur soit authentifié. Après authentification avec succès, un jeton est renvoyé pour être utilisé en entête dans chaque requête faute de quoi elle sera rejetée. Aussi est-il important de souligner que chaque jeton est valable pour une heure de temps. Il n'est donc pas nécessaire de demander un nouveau jeton dans ce laps de temps.

Vous trouverez aussi à droite dans ce document, des exemples de code pour differents language de programmation pour vous permettre de demarrer rapidement

Authentification

SuperCool SMS utilise des jetons pour autoriser l'accès à l'API. Vous avez besoin des informations de connexion pour ce faire. si vous en avez pas, veuillez contater le Service client https://supercoolsms.com/contact.

SuperCool SMS s'attend à ce que le jeton soit inclus dans toutes les demandes d'API adressées au serveur dans un en-tête qui ressemble à ce qui suit:

Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...

GetToken

curl --location --request POST 'https://supercoolsms.com/api/login_check' \
--data-raw '{"username":"test@test.com","password":"********"}'

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://supercoolsms.com/api/login_check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS =>"{\"username\":\"test@test.com\",\"password\":\"********\"}",
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

var data = "{\"username\":\"test@test.com\",\"password\":\"********\"}";

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://supercoolsms.com/api/login_check");

xhr.send(data);

CURL *curl;
CURLcode res;
curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
  curl_easy_setopt(curl, CURLOPT_URL, "https://supercoolsms.com/api/login_check");
  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
  curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
  struct curl_slist *headers = NULL;
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  const char *data = "{\"username\":\"test@test.com\",\"password\":\"********\"}";
  curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);
  res = curl_easy_perform(curl);
}
curl_easy_cleanup(curl);

import http.client
import mimetypes
conn = http.client.HTTPSConnection("supercoolsms.com")
payload = "{\"username\":\"test@test.com\",\"password\":\"********\"}"
headers = {}
conn.request("POST", "/api/login_check", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

require "uri"
require "net/http"

url = URI("https://supercoolsms.com/api/login_check")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request.body = "{\"username\":\"test@test.com\",\"password\":\"********\"}"

response = https.request(request)
puts response.read_body

Permet de s'authentifier pour récuperer le token

HTTP Request

POST https://supercoolsms.com/api/login_check

Query Parameters

Parameter Description
username votre nom d'utilisateur
password votre mot de passe

Example Response

SendSMS

curl --location --request POST 'https://supercoolsms.com/api/send_sms' \
--data-raw '{
  "expediteur": "TestAPI",
  "message": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
  "destinataire": "00000000000"
}'

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://supercoolsms.com/api/send_sms",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS =>"{\r\n  \"expediteur\": \"TestAPI\",\r\n  \"message\": \"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.\",\r\n  \"destinataire\": \"00000000000\"\r\n}",
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

var data = "{
\n  \"expediteur\": \"TestAPI\",
\n  \"message\": \"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.\",
\n  \"destinataire\": \"00000000000\"
\n}";

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://supercoolsms.com/api/send_sms");

xhr.send(data);

CURL *curl;
CURLcode res;
curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
  curl_easy_setopt(curl, CURLOPT_URL, "https://supercoolsms.com/api/send_sms");
  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
  curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
  struct curl_slist *headers = NULL;
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  const char *data = "{
\n  \"expediteur\": \"TestAPI\",
\n  \"message\": \"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.\",
\n  \"destinataire\": \"00000000000\"
\n}";
  curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);
  res = curl_easy_perform(curl);
}
curl_easy_cleanup(curl);

import http.client
import mimetypes
conn = http.client.HTTPSConnection("supercoolsms.com")
payload = "{\r\n  \"expediteur\": \"TestAPI\",\r\n  \"message\": \"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.\",\r\n  \"destinataire\": \"00000000000\"\r\n}"
headers = {}
conn.request("POST", "/api/send_sms", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

require "uri"
require "net/http"

url = URI("https://supercoolsms.com/api/send_sms")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request.body = "{\r\n  \"expediteur\": \"TestAPI\",\r\n  \"message\": \"Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.\",\r\n  \"destinataire\": \"00000000000\"\r\n}"

response = https.request(request)
puts response.read_body

Permet d'envoyer des SMS à un ou plusieurs destinataires. Pour envoyer à plusieurs destinataires, il faut séparer les numeros par des virgules dans la clé destinataire.

HTTP Request

POST https://supercoolsms.com/api/send_sms
Authorization Bearer Token

Query Parameters

Parameter Description
expediteur Expediteur alpha numerique
message Texte 160 caractère par page
destinataire Liste des destinataires séparer par des virgules

Example Response

GetBalance

curl --location --request GET 'https://supercoolsms.com/api/check_credit'

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://supercoolsms.com/api/check_credit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;


var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://supercoolsms.com/api/check_credit");

xhr.send();

CURL *curl;
CURLcode res;
curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
  curl_easy_setopt(curl, CURLOPT_URL, "https://supercoolsms.com/api/check_credit");
  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
  curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
  struct curl_slist *headers = NULL;
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  res = curl_easy_perform(curl);
}
curl_easy_cleanup(curl);

import http.client
import mimetypes
conn = http.client.HTTPSConnection("supercoolsms.com")
payload = ''
headers = {}
conn.request("GET", "/api/check_credit", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

require "uri"
require "net/http"

url = URI("https://supercoolsms.com/api/check_credit")

https = Net::HTTP.new(url.host, url.port);
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Permet de consulter le solde de crédit

HTTP Request

GET https://supercoolsms.com/api/check_credit
Authorization Bearer Token

Example Response

cURL PHP JavaScript C Python Ruby