SMS API Entegrasyonu Nasıl Yapılır?

DID Telekom SMS API'si, uygulamalarınızdan toplu SMS, OTP doğrulama ve iki yönlü SMS gönderimini kolayca entegre etmenizi sağlar. Bu rehberde adım adım entegrasyon sürecini anlatıyoruz.

API'ye Başlarken

1. Hesap Oluşturun: DID Telekom müşteri panelinden hesabınızı oluşturun.
2. API Anahtarı Alın: Paneldeki "Geliştirici" bölümünden API key ve secret oluşturun.
3. Sandbox Test: Ücretsiz sandbox ortamında test gönderimi yapın.
4. Canlıya Geçiş: Testleriniz başarılı olduktan sonra production ortamına geçin.

Tekli SMS Gönderimi

Basit bir HTTP POST isteğiyle SMS gönderebilirsiniz:

POST /api/v1/sms/send
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "to": "905xxxxxxxxx",
  "from": "FIRMAADI",
  "message": "Merhaba, siparişiniz kargoya verildi."
}

OTP Doğrulama

İki faktörlü kimlik doğrulama (2FA) için OTP SMS göndermek oldukça basittir:

POST /api/v1/otp/send
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "to": "905xxxxxxxxx",
  "length": 6,
  "expiry": 180
}

API otomatik olarak 6 haneli bir OTP SMS kodu üretir ve gönderir. Kullanıcının girdiği kodu doğrulamak için:

POST /api/v1/otp/verify
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "to": "905xxxxxxxxx",
  "code": "123456"
}

Toplu SMS Gönderimi

Birden fazla numaraya aynı anda SMS göndermek için:

POST /api/v1/sms/bulk
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "from": "FIRMAADI",
  "message": "Kampanya mesajınız burada",
  "recipients": [
    "905xxxxxxxxx",
    "905yyyyyyyyy",
    "905zzzzzzzzz"
  ]
}

Webhook ile Teslimat Raporları

SMS iletim durumlarını gerçek zamanlı olarak almak için webhook URL'nizi tanımlayın. Her SMS durumu değiştiğinde sisteminize bildirim gönderilir:

• delivered: SMS başarıyla iletildi
• failed: SMS iletilemedi
• pending: SMS operatöre iletildi, sonuç bekleniyor

SDK Desteği