CMFCell uygulamalara ve sistemlere mesaj alıp gönderebilme yeteneği kazandırmak isteyen kullanıcılar için SOAP protokolü üzerinden WebServis desteği sunmaktadır. Bu döküman kullanabileceğiniz metodların yapısı ve WebServisimizin nasıl kullanılacağı hakkında bilgi içerir.
SOAP protokolü kullanıcıların veri paketleri aracılığıyla uzak bir sunucudaki uygulamaya iletmesine olanak tanır. WebServisimizin adresini uygulamanıza referans olarak ekleyerek WebServisimize erişebilir ve aşağıda yer alan metodlar ile komutlar verebilirsiniz. Ayrıca SOAP WebServisimizi kullanan, yaygın programlama dillerine ait örnek kodlara erişmek için web sitemizde ilgili bölümleri inceleyebilirsiniz.
Uygulamanız üzerinden, http[s]://[servicePath]/sections/service/api/webservice/webservice.svc adresine referans göstermelisiniz.
Örnek olarak: http://smsc.cmfcell.com/sections/ service/api/webservice/webservice.svc
20 dakika boyunca geçerli olacak yeni bir oturum yaratır ve geriye SessionID döndürür. Sistemimiz üzerinde yeni bir oturum yaratıldığında, düz parola doğrulama rutinini uygulamanıza gerek kalmamaktadır.
|
Örnek Kod:
CMFCellClient_client = newCMFCellClient();
Guid_sessionId = _client.OpenSession("5010-test", "test");
|
CMFCell servisleri aracılığı ile mesaj gönderir ve geriye gönderilen mesajların MessageID’lerini döndürür.
|
Örnek Kod:
CMFCellClient_client = newCMFCellClient();
Guid_sessionId = _client.OpenSession("5010-test", "test");
SmsMessage_message = newSmsMessage {
SenderId = "CMFCELL.COM",
Recipients = newRecipientCollection() {
newRecipient() { Address = "905332669297" }
},
OutgoingSendDate = DateTime.Parse("2009-09-17 22:30"),
ValidityPeriod = 86400,
Content = "This is a test message"
};
Recipient[] _msgIds = _client.SendMessage(_sessionId, _message);
|
|
Örnek Kod:
CMFCellClient_client = newCMFCellClient();
Guid_sessionId = _client.OpenSession("5010-test", "test");
MmsMessage_message = newMmsMessage {
SenderId = "CMFMMS",
Recipients = newRecipientCollection() {
newRecipient() { Address = "905332669297" },
newRecipient() { Address = "905332669298" }
},
OutgoingSendDate = DateTime.Parse("2009-09-17 22:30"),
Subject = "Test Message",
Attachments = newMimeAttachmentCollection() {
newMimeAttachment() { EncodingType = TransferEncodingTypes.Base64, Mimetype = "image/jpg", Filename = "test.jpg", Data = System.IO.File.ReadAllBytes(@"C:\test.jpg") }
}
};
Recipient[] _msgIds = _client.SendMessage(_sessionId, _message);
|
Gelen kutusundan okunmamış ilk mesajı almaktadır. Ayrıca mesaj dizisi içerisinde “moveNextMessage” direktifiyle bir sonraki okunmamış mesaja geçebilirsiniz.
|
Örnek Kod:
CMFCellClient_client = newCMFCellClient();
Guid_sessionId = _client.OpenSession("5010-test", "test");
Message[] _messages = _client.GetMessage(_sessionId);
|
|
Örnek Kod:
CMFCellClient_client = newCMFCellClient();
Guid_sessionId = _client.OpenSession("5010-test", "test");
_client.MoveNextMessage(_sessionId);
|
Gönderilmiş bir mesajın durumunu sorgular.
· scode: Mesaj durumu hakkında bilgi verir.
o -1 – Mesaj bulunamadı
o 0 – Mesaj ulaştırılmış.
o 1 – Mesaj ulaştırılamamış.
o 2 – Mesaj beklemede.
· ecode: Mesaj ulaştırılamadıysa, hata hakkında açıklayıcı bilgi içerir.
o 102 – Mesaj iptal edilmiş.
o 103 – Mesaj yapısı geçersiz.
o 104 – Alıcı kapsama alanında değil.
o 105 – Mesaj limiti aşılmış.
o 106 – Mesaj tipi desteklenmiyor.
o 107 – Mesaj geçerlilik süresi sona ermiş.
o 108 – İzniniz bulunmuyor.
o 203 – Operator hatası.
o 204 – Operator bağlantısı sağlanamadı.
o 205 – Operator mesajı reddetti.
|
Örnek Kod:
CMFCellClient_client = newCMFCellClient();
Guid_sessionId = _client.OpenSession("5010-test", "test");
Recipient[] _recipientsToQuery = newRecipient[] {
newRecipient() { MessageId = "0000000014-0000001456" },
newRecipient() { MessageId = "0000000014-0000001457" }
};
Recipient[] _recipients = _client.GetStatus(_sessionId, _recipientsToQuery);
|
Hesap bilgisi ve kayıtlı originator listesini döndürür.
|
Örnek Kod:
CMFCellClient_client = newCMFCellClient();
Guid_sessionId = _client.OpenSession("5010-test", "test");
AccountInfoCollection_accountInfo = _client.GetAccountInfo(_sessionId);
|
Uzak sunucu bilgisi ve servis tarih/saat bilgisini döndürür.
|
Örnek Kod:
CMFCellClient_client = newCMFCellClient();
Guid_sessionId = _client.OpenSession("5010-test", "test");
ServerInfoCollection_serverInfo = _client.GetServerInfo(_sessionId);
|