İnteract (İnteraktif) SMS API

Mobildev Interact, uygulama geliştiricilerin, çözümlerine çift yönlü SMS uygulamaları geliştirmek için, XML teknolojisini kullanarak Mobildev SMS Gateway’a ulaşmalarını sağlamak amacıyla geliştirilmiştir.

Yazılım geliştiriciler, Mobildev Interact tarafından sunulan XML ifadelerini uygun şekilde hazırlayıp, http://api.smcollector.com/xmlapi.aspx (Bundan sonra Gateway olarak anılacaktır.) adresine gönderirler.

Gönderilen XML ifadeleri Gateway’a ulaştığında bir 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ını, hata kodları sayfasından görebilirsiniz.

Mobildev Interaktif SMS çözümümüzü aşağıdaki demo kullanıcı hesap bilgileriyle test edebilirsiniz.

Kullanıcı adı : devtest
Şifre : devtest
Mesaj toplama numarası: 905337789200

Aşağıdaki XML ifadesini, parametre düğümlerine istenen bilgileri ekleyerek Gateway’a yolladığınızda, IDList parametre düğümünde belirtmiş olduğunuz mesaj gönderim kodlarına (MsgID) sahip mesajlar size ait kullanıcı hesabından silinir:

Yukarıdaki XML ifadesinde:

UserName parametre düğümü: Mobildev’de kullanıcı adınızı,
PassWord parametre düğümü: Mobildev’de tanımlı olan kullanıcı adınıza ait şifreyi,
Action parametre düğümü: Gönderilen XML ifadesinin hangi işlev için gönderildiği bilgisini ifade eder.
IDList parametre düğümü: Size ait kullanıcı hesabından silmek istediğiniz mesajlara ait mesaj kodu bilgisini (MsgID) ifade eder.

Not: Eğer birden fazla mesajı aynı anda silmek istiyorsanız IDList parametre düğümüne, silmek istediğiniz mesajlara ait mesaj kodlarını (MsgID) virgülle ayırarak (1234,5687,3215 gibi) girin.

Aşağıdaki örnekte gönderilen mesaj(lar)ı silmek için gerekli XML ifadesi gösterilmektedir.

Örnek: Mesaj silmek için gerekli XML ifadesi

Yukarıdaki XML ifadesini Gateway’a gönderdiğinizde, aşağıdaki geri dönüş değerlerini alırsınız:

İşlem başarılıysa: “ok”
Hata oluşmuşsa: Bknz. Hata kodları

Mobildev Interaktif SMS çözümümüzü aşağıdaki demo kullanıcı hesap bilgileriyle test edebilirsiniz.

Kullanıcı adı: demo
Şifre: demo
Mesaj toplama numarası: 0533 281 2617

Aşağıdaki XML ifadesini, parametre düğümlerine istenen bilgileri ekleyerek Gateway’a yolladığınızda, geri dönüş değeri olarak size ait kullanıcı hesabı için toplanan mesajlar alınır:

Yukarıdaki XML ifadesinde:

UserName parametre düğümü: Mobildev’de tanımlı kullanıcı adınızı,
PassWord parametre düğümü: Mobildev’de tanımlı olan kullanıcı adınıza ait şifreyi,
Action parametre düğümü: Gönderilen XML ifadesinin hangi işlev için gönderildiği bilgisini,
List parametre düğümü: Kullanıcı hesabınıza ait toplanan mesajların hangilerini (Okunmuş, okunmamış, tümü) geri dönüş değeri olarak almak istediğinizi ifade eder.

List parametre düğümü üç değer alabilir:

1. Okunmuş mesajları almak için REC READ
2. Okunmamış mesajları almak için REC UNREAD
3. Tüm mesajları almak için ALL

Aşağıdaki örnekte gönderilen mesajları almak için gereken XML ifadesi gösterilmektedir.

Örnek: Gönderilmiş mesajları toplamak için gereken XML ifadesi

Yukarıdaki XML ifadesini Bir XMLHTTP isteği oluşturup Gateway’a gönderdiğinizde aşağıdaki geri dönüş değerlerini alırsınız:

İşlem başarılıysa ve kullanıcı hesabına gönderilen mesaj varsa:

• Kullanıcı hesabına gönderilen mesaj yoksa:
  ok 08

• Hata oluşmuşsa: Bknz. Hata kodları