İçeriğe geç
Toplu SMS API

İlk SMS

Aşağıdaki çağrılar aynı kök adresi kullanır. Her istek x-api-key başlığını taşır.

Terminal window
export SMS_API=https://sms.example
export SMS_KEY='anahtar'

Anahtar yalnızca kendisine verilmiş izinleri taşır. Gönderim açmak için create:sms, durum okumak için list:sms, iptal için cancel:sms gerekir.

Kontör

Section titled “Kontör”

Gönderimden önce bakiyeye bakmak isteyebilirsiniz. Hesabınızın kontörü yetmezse paket zaten açılmaz.

Terminal window
curl -s "$SMS_API/api/v1/sms/credit" -H "x-api-key: $SMS_KEY"

Gönderim

Section titled “Gönderim”

Metin ve numaralar tek istekte gider. Yer tutucu yoksa data içinde yalnız numara listesi yeter:

Terminal window
curl -s -X POST "$SMS_API/api/v1/sms/" \
  -H "x-api-key: $SMS_KEY" -H 'content-type: application/json' \
  -d '{"name":"Bayram","message":"Merhaba","data":{"phone":"905550000001, 905550000002"}}'

Kişiye özel metin için {ad} gibi tek süslü yer tutucu yazılır ve data dizi olur:

Terminal window
curl -s -X POST "$SMS_API/api/v1/sms/" \
  -H "x-api-key: $SMS_KEY" -H 'content-type: application/json' \
  -d '{"message":"Merhaba {ad}","data":[{"phone":"05550000001","ad":"Ayşe"}]}'

İleri tarih için scheduledAt (ISO 8601) eklenir; liste hemen üretilir, teslim anı gövdede taşınır:

Terminal window
curl -s -X POST "$SMS_API/api/v1/sms/" \
  -H "x-api-key: $SMS_KEY" -H 'content-type: application/json' \
  -d '{"message":"Merhaba","data":{"phone":"905550000001"},"scheduledAt":"2026-12-01T09:00:00+03:00"}'

Yanıt 202dir. id sonraki çağrılarda kullanılır.

Durumu okumak

Section titled “Durumu okumak”
Terminal window
curl -s "$SMS_API/api/v1/sms/GÖNDERİM_ID" -H "x-api-key: $SMS_KEY"
curl -s "$SMS_API/api/v1/sms/GÖNDERİM_ID/recipients" -H "x-api-key: $SMS_KEY"

status completed olunca counters altındaki giden adettir. Düşenlerin gerekçesi GET …/errors altındadır. Ayrıntı Gönderim durumları sayfasındadır.