SMS API, SMS uygulaması, SMS hizmeti, SMS gönderimi

SMS API Arayüzü

Web siteleri, CMS ve CRM sistemleri için SMS API.

API Belgeleri Başlayın

REST API

Hangi Olanakları Elde Edersiniz?

Tek entegrasyonla kayıt doğrulaması, işlem mesajları, OTP kodları, zamanlanmış gönderim ve geri çağırmayla durum bildirimlerini yönetin.

Entegrasyon Web Sitesi / CMS / CRM

Yöntem REST API

Gönderim OTP / Toplu / Zamanlanmış

Durumlar Geri Çağırma

SMS API entegrasyonu, SMS API, SMS geliştiricileri

Kullanım Alanları

SMS API entegrasyonu en çok şu durumlarda kullanılır:

Belirli bir cep telefonu numarasına bağlı kullanıcı kaydının SMS ile doğrulanması
Banka hesabı işlem bildirimleri
Sipariş durumları, kampanyalar, yeni ürünler ve her türlü SMS reklamının gönderimi

Nasıl Başlanır?

Giriş Yap

Bakiye Yükle

API Hizmetini Etkinleştir

Mesaj Gönder

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

Zorunlu Parametreler

Parametre	Açıklama
`key`	Sisteme bağlanmak için gizli API anahtarı. Anahtarı şirket ayarlarında görüntüleyip yönetebilirsiniz.
`brandID`	Sistemdeki gönderici markasının benzersiz kimliği.
`numbers`	Virgülle ayrılmış cep telefonu numaraları. Numaralar uluslararası biçimde olmalı; şu işaretleri içermemelidir: 00 ve +.
`text`	Mesaj metni. Tüm Unicode karakterlerine izin verilir.

İsteğe Bağlı Parametreler

Parametre	Açıklama
`stopList`	`stopList=false` — engelleme listesi kontrolünü kapatır. Alıcının numarası listede olsa bile mesaj gönderilir.
`otp`	`otp=true` — tek kullanımlık doğrulama kodları (OTP) için SMS. En yüksek öncelikle gönderilir. Yalnızca kimlik doğrulamada kullanın. Diğer mesaj türleri için kullanılmamalıdır.
`sendTime`	Zamanlanmış mesaj gönderim saati. Biçim: Y-m-d H:i (örneğin: 2026-02-01 23:30) Belirtilen zaman şimdiki zamandan sonra olmalıdır. Bu parametre belirtilmezse mesaj hemen gönderilir.
`callbackUrl`	Bu SMS isteğine özel geri çağırma URL'si. Yalnızca API uygulaması ayarlarında genel bir varsayılan geri çağırma URL'si tanımlıysa çalışır.

Mesaj Durumlarını Otomatik Alın (Geri Çağırma)

SMS API, sunucunuzda gönderilen mesajların teslim durumlarını otomatik almanızı sağlar. Kullanılan yöntem: Geri Çağırma mekanizması.

Mesaj durumu değiştiğinde (gönderildi, teslim edildi, başarısız vb.) sistem bir GET isteği gönderir. Belirttiğiniz HTTPS uç noktasına.

Geri Çağırma URL'si Gereksinimleri

URL şu şekilde başlamalıdır: https://
Yöntem: GET
Geri çağırma URL'si şirket ayarlarında yapılandırılır

GET İsteği Örneği

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

Dönen Parametreler

Parametre	Açıklama
`key`	Sunucunuz için geri çağırma doğrulama anahtarı.
`smsID`	Mesajın benzersiz kimliği.
`number`	Alıcının uluslararası biçimdeki cep telefonu numarası.
`statusID`	Mesajın güncel durum kodu.
`date`	Durum güncelleme zamanı ( Y-m-d H:i:s).

Durumların Anlamları

statusID	Açıklama
`0`	Gönderildi
`1`	Teslim Edildi
`2`	Başarısız
`3`	Beklemede
`4`	Hata

Geri Çağırma İşleme Örneği (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';
?>

Sunucunuz HTTP 200–299 durum kodu döndürürse geri çağırma başarılı sayılır.