Ana içeriğe geç

Basamaklı API

Cascade API, tek bir istekle birden fazla platformda mesaj gönderilmesine olanak tanır ve otomatik olarak Telegram Bot, Viber Bot, Viber Business Mesajları, RCS ve SMS'e yönlendirilir.

Temel URL

https://restapi.smsbat.com

Kimlik Doğrulama

Cascade API, üç olası kimlik doğrulama başlığıyla başlık tabanlı kimlik doğrulamayı kullanır:

Yöntem 1: SMSBAT API Anahtarı

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Authorization-Key: your-smsbat-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Yöntem 2: Viber Bot Tokenı

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Viber-Auth-Token: your-viber-bot-token" \
  -H "Content-Type: application/json" \
  -d @request.json

Yöntem 3: Telegram Bot Anahtarı

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Tg-Bot-Key: your-telegram-bot-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Mevcut Uç Noktalar

Yöntem Uç nokta Açıklama
YAYIN /api/CascadeMessage/send_message/async Genel kademeli mesaj gönderimi
YAYIN /api/CascadeMessage/send_message/tg-viber/async Telegram öncelikli basamak

Nasıl Çalışır?

Cascade, tek bir API isteğiyle mesajınızı birden fazla kanala otomatik olarak iletir:

Telegram Bot → Viber Bot → Viber Business → RCS → SMS

Mesaj, mümkün olan ilk kanal aracılığıyla iletilir ve teslimat başarısız olursa otomatik olarak bir sonraki kanala geri dönülür.

Temel Özellikler

Çok Kanallı Teslimat

Tek bir mesaj gönderin, istediğiniz platformdaki kullanıcılara ulaşın:

  • Telgraf Botu
  • Viber Botu
  • Viber İş Mesajları
  • RCS (Zengin İletişim Hizmetleri)
  • SMS

Değişken Değiştirme

Değişken yer tutucularla dinamik içerik kullanın:

  • %name=id% - Metin değişkenleri
  • %url=id% - URL değişkenleri
  • %short_url=id% - Kısaltılmış URL değişkenleri

Mesaj Planlama

Gelecekteki teslimat için mesajları planlayın:

{
  "scheduledTime": "2025-01-24T12:00:00Z"
}

Yaşam Süresi (TTL)

Mesajlar için son kullanma süresini ayarlayın:

{
  "ttl": 3600
}

Mesaj Türleri

Cascade API'si şunları destekler:

  • İşlemsel - Sipariş onayları, bildirimler
  • Tanıtım - Pazarlama ve tanıtım mesajları
  • Viber Surveys - İnteraktif anketler
  • Hızlı Aramalar - Telefon doğrulaması

Yanıt Formatı

Başarılı yanıtlar geri döner:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - İleti tanımlaması için GUID
  • trackinId - Teslimat durumunu izlemek için kullanılan dize

Hızlı Başlangıç

  1. Mesaj Gönder - Kademeli mesaj göndermeye başla
  2. Mesaj Değişkenleri - Dinamik içerik kullan
  3. Mesaj Türleri - Mesaj türlerini keşfedin

Talep Örneği

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "text": "Hello %name=1%, your order #%url=2% is ready!",
      "variables": [
        {
          "id": 1,
          "value": "John"
        },
        {
          "id": 2,
          "value": "12345"
        }
      ]
    }
  ]
}

Hata İşleme

HTTP durum kodları:

  • 200 OK - İstek başarılı
  • 400 Hatalı İstek - Geçersiz istek biçimi
  • 401 Yetkisiz - Kimlik doğrulama başarısız oldu
  • 429 Çok Fazla İstek - Oran sınırı aşıldı
  • 500 Dahili Sunucu Hatası - Sunucu hatası

Faydaları

Tek Entegrasyon

Tüm mesajlaşma kanalları için tek API entegrasyonu; her platformla ayrı ayrı entegrasyona gerek yoktur.

Otomatik Yönlendirme

Akıllı yönlendirme, mesajların her alıcı için mevcut en iyi kanal üzerinden iletilmesini sağlar.

Maliyet Optimizasyonu

Cascade önce daha ucuz kanalları dener ve yalnızca ihtiyaç duyulduğunda otomatik olarak daha pahalı seçeneklere geri döner.

Daha Yüksek Teslimat Oranları

Çoklu yedek kanallar, birincil kanal başarısız olsa bile mesajınızın alıcıya ulaşmasını sağlar.

Sonraki Adımlar