Documentație API SMS
Exemple PHP și cURL

← API și integrări

API-ul Kendalo primește cereri HTTP POST (application/x-www-form-urlencoded) și funcționează din orice limbaj care poate trimite un POST: PHP, Python, Node.js, C#, Java sau direct din cURL.

Endpoint-uri

Autentificare

Fiecare cerere conține parametrii api_user (adresa de email a contului) și api_key (cheia setată în cont).

Comenzi

Trimite SMS — cURL

curl -X POST https://sms.kendalo.ro/api.php \
  -d "api_user=email-cont@exemplu.ro" \
  -d "api_key=CHEIA_TA_API" \
  -d "comanda=trimite_sms" \
  -d "nr=07XXXXXXXX" \
  --data-urlencode "mesaj=Comanda ta a fost expediata."

Trimite SMS — PHP

<?php
$url = "https://sms.kendalo.ro/api.php";
$data["api_user"] = "email-cont@exemplu.ro"; // email-ul contului tău
$data["api_key"]  = "CHEIA_TA_API";          // cheia setată în cont
$data["comanda"]  = "trimite_sms";
$data["nr"]       = "07XXXXXXXX";
$data["mesaj"]    = "Comanda ta a fost expediata.";
// $data["id_campanie"] = 1337; // opțional, ID-ul primit la creare_campanie

$options = array(
    "http" => array(
        "header"  => "Content-type: application/x-www-form-urlencoded\r\n",
        "method"  => "POST",
        "content" => http_build_query($data),
    ),
);
$result = file_get_contents($url, false, stream_context_create($options));
if ($result === FALSE) { echo "eroare api sms"; }
echo $result; // ID-ul mesajului
?>

Trimite SMS internațional, cu nume de expeditor — PHP

<?php
$url = "https://sms.kendalo.ro/api_intl.php";
$data["api_user"] = "email-cont@exemplu.ro";
$data["api_key"]  = "CHEIA_TA_API";
$data["comanda"]  = "trimite_sms";
$data["nr"]       = "49XXXXXXXXX";  // fără + sau 00
$data["mesaj"]    = "Your order has been shipped.";
$data["sender"]   = "FIRMATA";      // implicit KENDALO

$options = array("http" => array(
    "header"  => "Content-type: application/x-www-form-urlencoded\r\n",
    "method"  => "POST",
    "content" => http_build_query($data),
));
$result = file_get_contents($url, false, stream_context_create($options));
var_dump($result);
?>

Verificare credit — PHP

<?php
$data = array(
    "api_user" => "email-cont@exemplu.ro",
    "api_key"  => "CHEIA_TA_API",
    "comanda"  => "verifica_credit",
);
$options = array("http" => array(
    "header"  => "Content-type: application/x-www-form-urlencoded\r\n",
    "method"  => "POST",
    "content" => http_build_query($data),
));
echo file_get_contents("https://sms.kendalo.ro/api.php", false, stream_context_create($options));
// Credit disponibil: 1234
?>

Status de livrare — PHP

<?php
$data = array(
    "api_user" => "email-cont@exemplu.ro",
    "api_key"  => "CHEIA_TA_API",
    "comanda"  => "verifica_status_sms",
    "id_mesaj" => "69741", // ID-ul primit la trimite_sms
);
$options = array("http" => array(
    "header"  => "Content-type: application/x-www-form-urlencoded\r\n",
    "method"  => "POST",
    "content" => http_build_query($data),
));
$result = json_decode(file_get_contents("https://sms.kendalo.ro/api.php", false, stream_context_create($options)), true);
print_r($result);
?>

Creare campanie — PHP

<?php
$data = array(
    "api_user"      => "email-cont@exemplu.ro",
    "api_key"       => "CHEIA_TA_API",
    "comanda"       => "creare_campanie",
    "nume_campanie" => "Black Friday 2026",
);
$options = array("http" => array(
    "header"  => "Content-type: application/x-www-form-urlencoded\r\n",
    "method"  => "POST",
    "content" => http_build_query($data),
));
print_r(json_decode(file_get_contents("https://sms.kendalo.ro/api.php", false, stream_context_create($options)), true));
?>

Ai nevoie de ajutor la integrare? Sună la 0724-169.966 sau scrie-ne.