Ana içeriğe geç

SMSBAT API'si

SMSBAT, Viber atlıkarınca, Viber görüş diyalogu, Viber promosyonu (resimler, video), Viber iş sohbeti, OTP bildirimleri (Viber OTP, Flash Call) ve bunların geri dönüş çeşitleri dahil olmak üzere çeşitli mesaj türlerini göndermek için bir RESTful API platformudur.

Temel URL

SMSBAT API'ye gelen istekler yerelleştirme ile uç noktaya iletilir. Adresi önceden Yöneticinizden isteyin.

Örnek: https://restapi.smsbat.com (gerçek URL bölgenize göre değişebilir)

Kimlik Doğrulama

SMSBAT API üç kimlik doğrulama yöntemini destekler:

Yöntem 1: HTTP Temel Kimlik Doğrulaması

Kullanıcı adınızı ve şifre bilgilerinizi kullanın:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d @request.json

Yöntem 2: API Anahtar Başlığı

'X-Authorization-Key' başlığını kullanın:

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

Yöntem 3: Parola Olarak API Anahtarı

Kullanıcı adı olarak @ ve şifre olarak API anahtarınızı kullanın:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Mevcut Uç Noktalar

Yöntem Uç nokta Açıklama
YAYIN /bat/messagelist Mesaj gönder
AL /bat/message/{messageId} Mesaj durumunu kontrol edin

Mesaj Türleri

SMSBAT API aşağıdaki mesaj türlerini destekler:

  • SMS - Standart kısa mesajlar
  • Viber Promosyonu - Zengin medya içeren tanıtım mesajları
  • Viber İşlemsel - İşlem bildirimleri
  • Viber Carousel - Etkileşimli atlıkarınca mesajları
  • Viber Survey - Görüş diyalog mesajları
  • Viber OTP - Tek seferlik şifre bildirimleri
  • RCS - Zengin İletişim Hizmetleri mesajları
  • Flaş Arama - Sessiz arama doğrulaması

Temel Özellikler

Yedek Mesajlaşma

Birincil dağıtım başarısız olduğunda SMSBAT otomatik olarak alternatif kanallara geri döner:

Viber → SMS → Email

Zengin Medya Desteği

Şununla mesaj gönder:

  • Görseller (JPG, PNG)
  • Videolar (MP4)
  • PDF'ler
  • Düğmeler ve eylem bağlantıları

Mesaj Durumu Takibi

Teslimat durumunu gerçek zamanlı olarak takip edin:

  • Gönderildi
  • Teslim edildi
  • Oku
  • Başarısız
  • Süresi dolmuş

Geri aramalar

İki yönlü iletişim için gelen Viber mesajı geri aramalarını alın.

Hızlı Başlangıç

  1. Mesaj Gönder - İlk mesajınızı nasıl göndereceğinizi öğrenin
  2. Durumu Kontrol Et - Mesaj teslim durumunu takip edin
  3. Mesaj Türleri - Farklı mesaj türlerini keşfedin

Talep Formatı

Tüm istekler aşağıdaki yapıya sahip JSON biçimini kullanır:

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "type": "viber",
      "text": "Your message here",
      // ... additional parameters
    }
  ]
}

Yanıt Formatı

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

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "recipient": "+380XXXXXXXXX",
      "status": "sent"
    }
  ]
}

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ı

Sonraki Adımlar