Ana içeriğe geç

SMS API

Servis URLS​

HTTPS API için: https://xmlapi.mobildev.com/

Belgenin Amacı​

Bu belge, toplu sms gönderim hizmetimizi kullanmak isteyen yazılım geliştiricilerin, sistemimize entegre olmalarını sağlayacak XML API aracının nasıl kullanıldığını açıklamak için hazırlanmıştır. Mobildev tarafından sağlanan API Key ve API Secret bilgileriniz ile servisi kullanmaya başlayabilirsiniz.

Sistem Gereksinimleri​

Mobildev XML API çözümünü kullanabilmeniz için gereken minimum sistem gereksinimleri aşağıda belirtilmiştir.

  • Windows 98 SE,ME,2000,XP,UNIX,Linux ya da MacOS İşletim Sistemi

  • Internet Explorer 6 SP1 (Windows Platformu için)

  • cURL kütüphanesi (PHP kullanan geliştiriciler için)

Kullanım Şekli​

Mobildev XML API, XML teknolojisi ve HTTP protokolü kullanılarak gerçeklenen, fiziksel üç katmanlı mimariye sahip Mobildev SMS Gateway’a istemci ucundan gelen taleplerin belirli standartlara uygun olarak gönderilmesini sağlamak amacıyla geliştirilmiştir.

Yazılım geliştiriciler, bu belgede belirtilen şekilde hazırlamış oldukları XML ifadelerini yukarıda belirtilen service URL(Bundan sonra Gateway olarak anılacaktır.) adresine, kendi çözümlerinde bir XML HTTP isteği oluşturarak gönderirler. Gönderilen XML ifadesi Mobildev XML Parser tarafından işlenir. Eğer XML ifadesinde ya da XML ifadesi içinde bulunan parametre düğümlerinin herhangi birinde bir hata oluşmuşsa, yakalanan hata HTTP üzerinden önceden tanımlı bir kod olarak göndericiye iletilir.

Eğer bir hata oluşmamışsa gönderilmiş olan XML ifadesinin işlevine uygun geri dönüş ifadesi hazırlanıp HTTP üzerinden göndericiye iletilir. Önceden tanımlı hata kodları, belgenin ilgili ayrımında ayrıntılı olarak açıklanacaktır.

Uyarılar​

Mobildev XML API çözümü aşağıdaki uyarılar göz önünde bulundurularak kullanılmalıdır.

Kampanya içerikli mesajları gönderebilmek için hesabınızda tanımlı Originator (alfanumerik) bilgileriniz ile IYS Kodunuzun veya marka kodunuzun eşleştirilmesi gerekmektedir, tanımlama için destek birimi ile iletişime geçebilirsiniz.

Mesaj içeriğinde Türkçe karakter veya XML formatını bozabilecek Linefeed, Enter, Tab veya özel karakterler bulunabilir, XML format hatası almamak için mesaj içeriklerinizi XML standartı olan CDATA içerisinde gönderebilirsiniz veya ilgili karakterleri XML standartlarına uygun olarak yazabilirsiniz.