SMS API, SMS tətbiqi, SMS xidməti, SMS göndərmə

SMS API interfeysi

Saytlar, CMS və CRM sistemləri üçün SMS API.

API sənədləri Başlayın

REST API

Hansı imkanları əldə edirsiniz?

Bir inteqrasiya ilə qeydiyyat təsdiqi, tranzaksiya mesajları, OTP kodları, planlı göndəriş və callback vasitəsilə statusların alınmasını idarə edin.

İnteqrasiya Sayt / CMS / CRM

Metod REST API

Göndərmə OTP / Kütləvi / Planlı

Statuslar Geri çağırış

SMS API inteqrasiyası, SMS API, SMS proqramçıları

İstifadə halları

SMS API inteqrasiyası ən çox bu hallarda istifadə olunur:

SMS vasitəsilə konkret mobil nömrəyə bağlı istifadəçi qeydiyyatının təsdiqi
Bank hesabı əməliyyatları haqqında bildirişlər
Sifariş statusları, kampaniyalar, yeni məhsullar və hər növ SMS reklamının göndərilməsi

Necə başlamaq olar

Daxil ol

Balansı artır

API xidmətini aktivləşdir

Mesaj göndər

https://api.ubill.dev/v1/sms/send?key=0123456789&brandID=1&numbers=995511194242,995511194242&text=message

Məcburi parametrlər

Parametr	Təsvir
`key`	Sistemə qoşulmaq üçün məxfi API açarı. Açarı şirkət parametrlərində görə və idarə edə bilərsiniz.
`brandID`	Sistemdə göndərən brendin unikal ID-si.
`numbers`	Vergüllə ayrılmış mobil nömrələr. Nömrələr beynəlxalq formatda olmalıdır, bu işarələrsiz: 00 və +.
`text`	Mesaj mətni. İstənilən Unicode simvollarına icazə verilir.

İxtiyari parametrlər

Parametr	Təsvir
`stopList`	`stopList=false` — stop-siyahı yoxlamasını söndürür. Alıcının nömrəsi stop-siyahıda olsa belə mesaj göndəriləcək.
`otp`	`otp=true` — birdəfəlik giriş kodları (OTP / təsdiq kodu) üçün SMS. Ən yüksək prioritetlə göndərilir. Yalnız autentifikasiya zamanı istifadə edin. Digər mesaj növləri üçün istifadə edilməməlidir.
`sendTime`	Planlaşdırılmış göndəriş vaxtı. Format: Y-m-d H:i (məsələn: 2026-02-01 23:30) Göstərilən vaxt cari vaxtdan sonra olmalıdır. Parametr verilməzsə mesaj dərhal göndərilir.
`callbackUrl`	Bu SMS sorğusu üçün fərdi callback URL-i. Yalnız API tətbiqi parametrlərində qlobal standart callback URL-i göstərildikdə işləyir.

Mesaj statuslarını avtomatik alın (Callback)

SMS API serverinizdə göndərilmiş mesajların çatdırılma statuslarını avtomatik almağa imkan verir. Bunun üçün istifadə olunur: Geri çağırış mexanizmi.

Mesajın statusu dəyişdikdə (göndərildi, çatdırıldı, uğursuz və s.) sistem göndərir: GET sorğusunu təyin etdiyiniz HTTPS endpoint ünvanına.

Callback URL tələbləri

URL bununla başlamalıdır: https://
Metod: GET
Callback URL şirkət parametrlərində təyin olunur

GET sorğusu nümunəsi

https://example.com/callback?key=YourCallbackKey&smsID=12345678&number=995511194242&statusID=1&date=2026-02-01 12:02:02

Qaytarılan parametrlər

Parametr	Təsvir
`key`	Serverinizdə callback yoxlama açarı.
`smsID`	Mesajın unikal identifikatoru.
`number`	Alıcının beynəlxalq formatda mobil nömrəsi.
`statusID`	Mesajın cari status kodu.
`date`	Statusun yenilənmə vaxtı ( Y-m-d H:i:s).

Statusların mənası

statusID	Təsvir
`0`	Göndərildi
`1`	Çatdırıldı
`2`	Çatdırılmadı
`3`	Gözləmədə
`4`	Xəta

Callback emalı nümunəsi (PHP)

<?php
$key      = $_GET['key'] ?? null;
$smsID    = $_GET['smsID'] ?? null;
$number   = $_GET['number'] ?? null;
$statusID = $_GET['statusID'] ?? null;
$date     = $_GET['date'] ?? null;

// Validation: make sure key matches your callback key
if ($key !== 'YourCallbackKey') {
    http_response_code(403);
    echo 'Forbidden';
    exit;
}

// Process the received status in your system here

http_response_code(200);
echo 'OK';
?>

Serveriniz HTTP 200–299 status kodu qaytardıqda callback uğurlu sayılır.