Sistem Gereksinimleri Toplanmış Mesajları Silme İnteraktif SMS Api Örnek Kodları

Mesaj Toplama Hata Kodları

İnteraktif SMS API Kullanım Kılavuzunu indirmek için TIKLAYINIZ!

Genel

Mobildev İnteraktif API, uygulama geliştiricilerin, çözümlerinde çift yönlü SMS uygulamaları (Mesaj Toplama, Oylama Sistemleri, Müşteri İlişkileri Yönetimi vb.) geliştirmek için, XML teknolojisini kullanarak Mobildev SMS Gateway’e ulaşmalarını sağlamak amacıyla geliştirilmiştir.

Yazılım geliştiriciler, Mobildev İnteraktif API tarafından sunulan XML ifadelerini, belirtilen ş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’e ulaştığında 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.

İnteraktif SMS kullanıcısı olmak için;

• Sağlıklı bir internet bağlantısı,

• İnteraktif özelliğe açık bir 11 haneli uzun numara veya 4 haneli kısa numara seçimi ve bu numaranın Toplu Mesajlaşma hesabınızda tanımlatılması gerekiyor.

Detaylı bilgi için TIKLAYINIZ.

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)

Mesaj Toplama

Aşağıdaki XML ifadesi, parametre düğümlerine istenen bilgiler eklenerek Gateway’e yollandığında, geri dönüş değeri olarak belirtilen kullanıcı hesabı için toplanan mesajlar alınır:

<SMCollectorMain>
<UserName>username</UserName>
<PassWord>password</PassWord>
<Action>0</Action>
<List>ALL</List>
</SMCollectorMain>

Yukarıdaki XMl ifadesinde:

Username: Mobildev SMS hesabı üzerinde tanımlı kullanıcı adınızı ifade eder.
Password: SMS kullanıcı adınıza ait şifreyi ifade eder.
Action: Gönderilen XML ifadesinin hangi işlev için gönderildiği bilgisini ifade eder.
List: İnteraktif SMS 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.

Unutmayın: List parametre düğümü üç değer alabilir: Okunmuş mesajları almak için REC READ Okunmamış mesajları almak için REC UNREAD Tüm mesajları almak için ALL!

Gönderilmiş Tüm Mesajları Toplamak İçin Gereken XML İfadesi Örneği

<SMCollectorMain>
<UserName>demo</UserName>
<PassWord>demo</PassWord>
<Action>0</Action>
<List>ALL</List>
</SMCollectorMain>

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

1. İşlem başarılıysa ve kullanıcı hesabının tanımlı olduğu numaraya gönderilen mesaj varsa: <resultset>
<row>
<id></id>
<msgdate></msgdate>
<msgbody></msgbody>
<gsmno></gsmno>
<status></status>
</row>
<row>
<id></id>
<msgdate></msgdate>
<msgbody></msgbody>
<gsmno></gsmno>
<status></status>
</row>
</resultset>

   
   
2. Kullanıcı hesabının tanımlı olduğu interaktif numaraya gönderilen mesaj yoksa:
   ok 08
3. Hata oluşmuşsa: Bknz. Hata Kodları
   
   

Toplanmış Mesajları Silme

Asağıdaki XML ifadesi, parametre düğümlerine istenen bilgiler eklenerek Gateway’e yollandığında, IDList parametre düğümünde belirtilen mesaj gönderim kodlarına (MsgID) sahip mesajlar belirtilen İnteraktif SMS kullanıcı hesabından silinir:

<SMCollectorMain>
<UserName>your-username</UserName>
<PassWord>your-password</PassWord>
<Action>1</Action>
<IDList>MsgID</IDList>
</SMCollectorMain>

Yukarıdaki XML ifadesinde:

Username: Mobildev SMS hesabı üzerinde tanımlı kullanıcı adınızı ifade eder.
Password: SMS kullanıcı adınıza ait şifreyi ifade eder.
Action: Gönderilen XML ifadesinin hangi işlev için gönderildiği bilgisini ifade eder.
IDList: IDList parametre düğümü, size ait İnteraktif SMS kullanıcı hesabınızdan silmek istediğiniz mesajlara aitmesaj kodu bilgisini (MsgID) ifade eder.

Unutmayın: Eğer birden fazla mesajı aynı anda silmek istiyorsanız IDList parametre düğümüne, silmekistediğiniz mesajlara ait mesaj kodlarını (MsgID) virgülle ayırarak; 1234,5687,3215 örneğindeki gibi girmelisiniz!

Mesaj Silmek İçin Gerekli XML İfadesi

<SMCollectorMain>
<UserName>demo</UserName>
<PassWord>demo</PassWord>
<Action>1</Action>
<IDList>1234,5687,3215</IDList>
</SMCollectorMain>

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

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

Unutmayın: İnteraktif numaranıza toplayacağınız mesajlara yanıt vermek için Mobildev Toplu SMS hesabınızı kullanabilirsiniz. Entegrasyonla ilgili destek almak için SMS API sayfasını ziyaret edebilirsiniz. Otomatik geri dönüşlerde Mobildev Toplu SMS hesabınıza tanımlı olan ilk alfanumerik kullanılarak mesajlar gönderilir.

Hata Kodları

Hata Kodu	Açıklama
err 00	Tanımlanamayan hata
err 01	Hatalı Kullanıcı Adı veya Hatalı Parola
err 02	Eksik bilgi girişi
err 03	Tanımlanamayan Action bilgisi
err 04	Gelen XML yok
err 04	Hatalı XML geldi

İnteraktif SMS Api Örnek Kodlar

	VB Projesi		Delphi Projesi
	C# Projesi