İçeriğe geç

0850 870 0 767

[email protected]
noktasms

SMS API

Uygulamanızdan API ile SMS gönderimi.

REST ve JSON tabanlı SMS API ile siparişten doğrulamaya kadar tüm mesajlarınızı yazılımınızdan otomatik gönderin; teslim raporlarını ve bakiyenizi anında sorgulayın.

SMS API ile neler yapabilirsiniz?

SMS API, kendi yazılımınızın noktasms altyapısıyla doğrudan bağlantı kurmasını sağlayan bir arayüzdür. Web sitenizdeki üyelik formu, e-ticaret sepeti, CRM sisteminiz ya da mobil uygulamanız bir olay gerçekleştiğinde API'ye bir istek gönderir; mesaj saniyeler içinde alıcıya iletilir. Böylece manuel panel gönderimine ihtiyaç duyulmaz. Hızlı SMS ve garantili SMS yaklaşımımız API trafiğinde de geçerlidir.

API üzerinden hem toplu SMS hem de OTP SMS gönderimi yapabilirsiniz. Tek alıcıya kod göndermek de, binlerce kişilik bir listeye kampanya iletmek de aynı mantıkla çalışır. İstek gövdesinde alıcı numarası veya numaralar listesi, onaylı gönderici başlığı ve mesaj metni yer alır. Yanıtta ise her mesaj için bir kimlik döner; bu kimlikle teslim durumunu daha sonra sorgulayabilirsiniz.

Basit, öngörülebilir, belgelenmiş.

REST / JSON

Standart HTTP istekleri ve JSON yanıtlar; her dilde çalışır.

Kimlik doğrulama

Her istek hesabınıza özel kimlik bilgisiyle doğrulanır.

Durum sorgusu

Mesaj kimliğiyle teslim, bekliyor ve hata durumlarını öğrenin.

Teknik destek

Entegrasyon sürecinde sorularınıza geliştirici bilen ekibimiz yanıt verir.

İlk SMS'i API ile gönderin

Aşağıdaki örnekler yapıyı göstermek içindir. Güncel uç nokta adresi ve kimlik bilgileriniz, üye olduktan sonra panelinizdeki API ayarları bölümünde yer alır.

cURL

curl -X POST "https://api.domain.com/v1/sms/send" \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "header": "MARKAADI",
    "to": ["5XXXXXXXXX"],
    "message": "Merhaba, ilk SMS gönderiminiz başarılı."
  }'

PHP

$payload = json_encode([
    'header'  => 'MARKAADI',
    'to'      => ['5XXXXXXXXX'],
    'message' => 'Doğrulama kodunuz: 482913',
]);

$ch = curl_init('https://api.domain.com/v1/sms/send');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer API_ANAHTARINIZ',
        'Content-Type: application/json',
    ],
]);
$response = curl_exec($ch);
curl_close($ch);

Entegrasyon önerileri

Başarılı bir SMS API entegrasyonu için birkaç temel uygulama önerilir. Öncelikle API kimlik bilgilerinizi kaynak koda gömmek yerine ortam değişkenlerinde veya güvenli bir gizli anahtar deposunda saklayın. İstekleri yalnızca sunucu tarafından yapın; tarayıcıdan veya mobil uygulamadan doğrudan göndermek anahtarınızın ifşa olmasına yol açar. Ayrıca kullanıcıdan gelen numaraları göndermeden önce biçim kontrolünden geçirin, böylece hatalı numaralara boşuna kredi harcamazsınız.

OTP SMS gönderiminde aynı numaraya art arda talepleri sınırlamak (rate limit), kodları kısa süreli geçerli tutmak ve her kodu yalnızca bir kez kabul etmek hem güvenliği hem de maliyet kontrolünü sağlar. Toplu gönderimlerde ise büyük listeleri makul parçalara bölmek ve yanıt kimliklerini kendi veritabanınızda saklamak, sonradan raporlama yaparken işinizi çok kolaylaştırır. Hata durumlarında yeniden deneme mantığı eklerken aynı mesajı yanlışlıkla iki kez göndermemek için kendi tarafınızda benzersiz bir işlem kimliği tutmanızı öneririz.

Hazır bağlantı seçenekleri arıyorsanız popüler platformlar için hazırladığımız entegrasyonlar sayfasını inceleyin. Sorularınız için teknik ekibimize iletişim sayfasından ya da telefonla ulaşabilirsiniz. Gönderim maliyetleri için güncel SMS paketleri fiyatlarımızı değerlendirebilirsiniz.

API hakkında sorular

API için ayrı bir ücret ödenir mi?

API erişimi için ek bir ücret alınmaz; yalnızca gönderdiğiniz SMS'ler satın aldığınız paket kredisinden düşülür.

API kimlik bilgilerimi nereden alırım?

Üye girişi yaptıktan sonra panelinizdeki API ayarları bölümünden kimlik bilgilerinizi görüntüleyebilir ve yenileyebilirsiniz.

Teslim durumunu API ile sorgulayabilir miyim?

Evet. Gönderim yanıtında dönen mesaj kimliği ile teslim durumunu sorgulayabilir, ayrıca bakiye bilginizi API üzerinden alabilirsiniz.

API erişiminizi alarak entegrasyona başlayın

Üyelik ücretsizdir. Panel üzerinden paketinizi seçerek gönderime kısa sürede başlayabilirsiniz.