HTTP POST Yöntemi ile Toplu SMS Gönderimi

HTTP POST Yöntemi ile SMS Gönderimi

HTTP POST yöntemi, veri boyutu yüksek olan gönderimlerinizde ve karmaşık mesaj yapılarında tercih edilen bir yöntemdir. XML formatında veri göndererek İleti Merkezi altyapısına ulaştırmanızda kolaylık sağlar.

Bu yöntem, yüksek hacimli gönderimler ve çoklu mesaj çizelgeleri için daha uygun olup, daha detaylı kontrole imkan verir.

XML Yapısı ve Parametreleri

Aşağıdaki gibi oluşturduğunuz XML’i http://api.iletimerkezi.com/v1/send-sms adresine HTTP POST yöntemi ile göndermeniz gerekmektedir.

<request>
  <authentication>
    <username>KULLANICI_ADI</username>
    <password>KULLANICI_SIFRESI</password>
  </authentication>
  <order>
    <sender>BASLIK_ADI</sender>
    <senddatetime>01/05/2024 18:00</senddatetime>
    <message>
      <text><![CDATA[Mesaj metni buraya yazılır. Türkçe karakterler kullanılabilir.]]></text>
      <receipents>
        <number>905301234567</number>
        <number>905309876543</number>
      </receipents>
    </message>
  </order>
</request>

XML Parametrelerinin Açıklaması

Kimlik Doğrulama (authentication)

• username: İleti Merkezi paneline giriş yaparken kullandığınız kullanıcı adı
• password: İleti Merkezi paneline giriş yaparken kullandığınız şifre

Gönderim Bilgileri (order)

• sender: SMS'in alıcı telefonunda hangi isimle göründeceğini belirtir. Önceden onaylı başlık adı olmalıdır
• senddatetime: SMS'in gönderilmesi için planladığınız tarih ve saat. Hemen gönderim için boş bırakılabilir
• text: Gönderilecek SMS metni. CDATA bölümü kullanarak Türkçe karakterler ve özel karakterler sorunsuzca kullanılabilir
• receipents: Alıcıların telefon numaralarının listelendiği bölüm. Her alıcı için bir <number> etiketi kullanılır

Avantajları

HTTP POST yöntemi sayesinde:

• Yüksek Hacimli Gönderimler: Binlerce alıcıya tek bir istekte gönderim yapabilirsiniz
• Karakter Uyumluluğu: CDATA bölümü sayesinde Türkçe karakterler sorunsuzca kullanılır
• Çoklu Mesajlar: Bir istekte birden fazla farklı mesajı ve alıcı grubunu işleyebilirsiniz
• Planlı Gönderim: senddatetime parametresiyle gelecek tarihte otomatik gönderim planlayabilirsiniz

11 Temmuz 2015