Sistem Gereksinimleri İçerik Tipleri, İsimlendirme, Boyut ve Formata İlişkin Uyarılar Gönderen Bilgisi Kullanımına İlişkin Uyarılar Raporlamaya İlişkin Uyarılar MMS Soap Api Örnek Kodları

Kullanıcı Bilgilerinin Kontrolü GSM Numarası Formatına İlişkin Uyarılar MMS Gönderiminde (SendMMS) Kullanılacak Yönteme İlişkin Uyarılar Hata Kodları

MMS SOAP API Kullanım Kılavuzunu indirmek için TIKLAYINIZ!

Genel

Mobildev Web Servisi, XML teknolojisi ve HTTP protokolü kullanarak gerçekleşen, fiziksel üç katmanlı mimariye sahip Mobildev servisine istemci ucundan gelen taleplerin belirli standartlara uygun olarak gönderilmesini sağlamak amacı ile geliştirilmiştir.

Çözüm Geliştiriciler, http://gateway.mobilus.net/mms/mmsws.asmx adresini kullanarak servise erişebilirler.

Sistem Gereksinimleri

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

• Windows 98 SE, ME, 2000, XP, 2003, Linux, UNIX ya da MAC OS işletim sistemi

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

Kullanıcı Bilgilerinin (getUserInfo) Kontrolü

SMS gönderimine başlamadan önce SMS kullanıcı bilgilerinin kontrolü sağlanmalıdır. Mevcut SMS hesabınız bulunmuyorsa test hesabı almak için 444 0 554 numaralı telefondan Mobildev Müşteri Hizmetlerine ulaşabilirsiniz.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<getUserInfo xmlns="http://gateway.mobilus.net/mms/">
<UserName>test</UserName>
<CompanyCode>mb1000</CompanyCode>
<Password>1234</Password>
</getUserInfo>
</soap:Body>
</soap:Envelope>

Gönderilen Değerler
SetUsername: Mobildev SMS hesabı üzerinde tanımlı kullanıcı adınızı ifade eder.
SetPassword: SMS kullanıcı adınıza ait şifreyi ifade eder.
CompanyCode: Mobildev hesabınızın bağlı olduğu kanal kodunuzu ifade eder.

Geri Dönüş Değerleri

1. İşlem Başarılıysa:

<MMSRoot>
<Status>00</Status>
<ReturnData>
<Credit>1234567</Credit>
<OriginatorList>
<Originator>Originator1</Originator>
<Originator>Originator2</Originator>
</OriginatorList>
</ReturnData>
</MMSRoot>
Credit : Kullanıcı hesabına ait o anki kredi bilgisi
OriginatorList: Kullanıcı hesabına ait gönderen bilgisi listesidir.



2. İşlem Hatalıysa: <MMSRoot>
<Status>01</Status>
</MMSRoot>Status işlemin hata kodu için dönen değerdir. Detaylı bilgi için bknz.. Hata Kodları

İçerik Tipleri, İsimlendirme, Boyut ve Formata İlişkin Uyarılar

Dosya isimlerinde İsimlendirme OMA standartlarına uygun olmalıdır. Türkçe karakter kesinlikle kullanılmamalıdır.

Unutmayın: Kullanılacak harfler ve karakterler [A-Z], [0-9], _, - , . şeklindedir. Boşluk karakteri kesinlikle kullanılmamalıdır!

Önerdiğimiz ve desteklenen dosya tipleri şunlardır:

image/gif

image/jpeg

text/plain

audio/amr

audio/midi

audio/3gpp

video/3gpp

audio/mp3

audio/synthetic formats: (midi, smaf[1-3])

 

Unutmayın: AAC, audio, video gönderileceği, tanım yaparken mutlaka belirtilmelidir. Bu, tanım yaparken gerekli bir bilgidir!

İçerik Boyutu:
İdeal şartlarda en düzgün çevirime ulaştığımız maksimum mesaj boyutu için önerimiz 100 K'dır. Bu, tüm mesajın boyutudur; içeriğinde smil, multiple gif vs. barındırabilir.

Unutmayın: Message size 100K dan büyük olduğu durumlarda mesaj daha düsük kapsamlı telefonlara gönderildiğinde kalite bozulma ve telefonunun mesajı indirememe riski artacaktır!

İçeriğin Doğruluğu:
İçeriğin doğruluğundan 3. parti sorumludur. Örnek olarak; içeriğin header ve footer kısmında garbage karakter bulunması, bozuk içerik, yanlış dosya uzantısı kullanımı için Turkcell tarafında düzeltme yapılamaz, bu konularda tüm sorumluluk içerik sağlayıcıya aittir.

İçerik İle İlgili Hususlar:
İmaj: İmaj çözünürlüğü şu şekilde olmalıdır:
• Landscape- 320x240
• Square- 240x240

Unutmayın: Eğer içerikte bir imajdan fazla obje var ise bu durumda imaj çözünürlükleri 160x120 ve 10 Kb büyüklükte tutulması tavsiye edilir.

Animated gif:
Aşağıdaki tablo her animated gif içeriği için önerilen maksimum slide sayısını vermektedir.

Source Resolution	MMS Size Group	Maximum Number of Frames
Up to 128X128	100Kb	15 frames
128X128 to 176X208	100Kb	10 frames

Unutmayın: Önerilen mesaj boyutu 100 K'dır. Daha üzeri çözünürlükte, boyut, frame sayısı değişecektir!

Audio Format:

Audio Format	MMS Size Group	Audio Parametres
NbAMR	100Kb	12,2 kbps, 8 KHz, 16 bps
mp3	100Kb	64 kbps, 32 KHz, 16 bps, stereo
mp3	100Kb-300Kb	128 kbps, 48 KHz, 16 bps, stereo
AAC	100Kb-300Kb	128 kbps, 48 KHz, 16 bps, stereo

Unutmayın: Önerilen mesaj boyutu 100 K'dır.

Video Format:
Maksimum 30 saniye sürmelidir.
- Ortalama bitrate 128 kbps olmalıdır.
- Çözünürlük: 176 x 144 olmalıdır.
- Saniyede 15 frame desteklemelidir.
- Tercih edilen input formatı:

• 3gp dosya formatı
• Video codec: mpeg4
• Audio codec: aac

Text Format:
Yalnızca textten oluşan bir slide 6 satırı geçmemelidir. Fazlası diğer slidelara yayılacaktır.

Unutmayın: Her slide üzerindeki text 18-30 kelime ile limitli olmalıdır ki abone “scroll” islemini fazla gerçeklemeden okuyabilsin.

SMIL
Bir MMS'in diğer içeriğin yanı sıra SMIL sunumu barındırması tavsiye edilir.
- SMIL standartına uyulmalıdır: (OMA 1.1, OMA 1.2)

• İçerik ismi SMIL içerisinde referanslanmalıdır.
• Frame içerisindeki bölge tanımları iç içe geçmeyecek şekilde tasarlanmalıdır.
• SMIL'deki her nesne tanımlı olan bir bölge ile ilişkilendirilmelidir.
• Her slide üzerindeki MMS/SMIL layout/region tanımlarının OMA uyumlu olması gerekir. Slide başına Layout ve 2 bölge tanımı olmalı, bölgeler ihtiyaca göre Image&text olmalıdır.
• Her slide (eğer birden fazla obje içeriyor ise) şunlarla kısıtlıdır:
  
  • Image ve text
  • Image ve audio
  • Image, audio, ve text
  • Audio ve text
  • Video ve text

- SMIL’in en fazla 7 adet slide sayısından olusması tavsiye edilir.

SMIL İçeriği:
SMIL'de çoklu slide içerisinde video ve text referanslanıyor olabilir (text ve video ayrı slide'larda iken). Bu durumda text içeren slide video'dan önce gelmelidir.

• SMIL'de aynı slide içerisinde imaj ve text'e aynı anda referanslama var ise text uzunluğu 3 satırı geçmemelidir. Yoksa text diğer slide'lara doğru taşar.
• Bir slide içerisinde animated gif.e referans ediliyor ise bu slide süresi gerçek animated gif süresine göre ayarlanmalıdır.
• Animated gif.de yalnızca text var ise tavsiye edilen süre 6 saniyedir.

GSM Numarası Formatına İlişkin Uyarılar

GSM numaraları 05321234567, 5321234567, 905321234567 şeklinde ve Numbers parametre düğümü içerisinde yazılmalıdır.

Unutmayın: MMS gönderilecek numaralar başlarında “0”, “90”, “0090” gibi prefiksler olmadan “5321234567”formatında yazılmalıdır.!

Gönderen Bilgisi (Alfanumerik/Originator) Kullanımına İlişkin Uyarılar

Gönderen Bilgisi (Alfanumerik/Originator), mesaj gönderimlerinde gönderici kısmında yer alan; firmaya özel tanımlanmış 11 karakterden oluşan gönderici adıdır. Gönderim sırasında hesap aktivasyonunda aktivasyon biriminin tanımladığı Gönderen Bilgisi'nin aynısı Originator Parametre düğümü içerisinde yazılmalıdır. Gönderen Bilgisi tanımlı bilgiyle eşleşmezse 02 Hata Kodu alınır. Hata Kodu 02, Tanımsız Originator bilgisi anlamına gelir.

Unutmayın: Originator ifadesinde Türkçe karakterler ve &, <, >, -, ( ), [ ], / gibi simgeler kesinlikle kullanılmamalıdır!

MMS Gönderiminde (SendMMS) Kullanılacak Yönteme İlişkin Uyarılar

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<SendMMS xmlns="http://gateway.mobilus.net/mms/">
<UserName>test</UserName>
<CompanyCode>mb1000</CompanyCode>
<Password>1234</Password>
<Originator>MOBILDEV</Originator>
<Subject>KUTLAMA</Subject>
<GSMNumbers>05321234567</GSMNumbers>
<FileName>string</FileName>
<FileData>base64Binary</FileData>
<SDate>2012-12-31</SDate>
</SendMMS>
</soap:Body>
</soap:Envelope>

Gönderilen Değerler
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.
Originator: Mesajın gönderildiği GSM numarasında gönderen kısmında çıkacak kullanıcı adını ifade eder.
Subject: Gönderilecek MMS başlığı bilgisini ifade eder. En fazla 100 karakter olabilir.
GSMNumbers: MMS gönderilecek GSM numaraları listesini ifade eder. Bu bölümde GSM Numaraları XML olarak gönderilmelidir!

XML Örneği
<GSMNUMBERS>
<GSM>5321234567</GSM>
<GSM>5331234567</GSM>
</GSMNUMBERS>
FileName: Dosya adı alanını ifade eder. Dosyanın tipi ve bazı telefonlarda MMS attach edilmiş dosyanın adı yazdığı için kullanıcı tarafında görünen dosya adı olması sebebi ile önemlidir.
FileData: gönderilecek dosyanın byte halidir. Net örnek olarak kısaca System.IO.File.ReadAllBytes("C:\mms\kandil.gif") şeklindedir.
SDate: MMS’in gönderileceği tarih bilgisidir. Geçerli format yyyy-mm-dd hh:mm:ss.ms
Örnek: 2012-10-01 13:59:59.000

Geri Dönüş Değerleri

İşlem Başarılıysa: <MMSRoot>
<Status>00</Status>
<ReturnData>
<ID>26</ID>
</ReturnData>
</MMSRoot>
Status 00 işlem başarılı bilgisidir. Eğer status bilgisi 00'dan farklı bir değer olursa ReturnData bilgisi dönmez. Ve status değeri hata değerlerinden birisini alır. Bknz. Hata Kodları

Raporlamaya İlişkin Uyarılar

Raporlama (GetReport)
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<getReport xmlns="http://gateway.mobilus.net/mms/">
<UserName>test</UserName>
<CompanyCode>mb1000</CompanyCode>
<Password>1234</Password>
<ID>26</ID>
</getReport>
</soap:Body>
</soap:Envelope>

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.
CompanyCode: Mobildev SMS heasbına bağlı olduğunuz kanal kodunuzu ifade eder.
ID: Gönderilen MMS'e ait Paket ID bilgisini ifade eder.

Geri Dönüş Değerleri
<MMSRoot>
<Status>00</Status>
<ReturnData>
<GSMNo>00905321234567</GSMNo>
<Status>1</Status>
<GSMNo>00905331234567</GSMNo>
<Status>2</Status>
</ReturnData>
</MMSRoot>

Status 00 işlem başarılı bilgisidir. Eğer status bilgisi 00'dan farklı bir değer olursa ReturnData bilgisi dönmez ve status değeri hata değerlerinden birisini alır. Bknz. Hata Kodları.


ReturnDataiçerisinde GSM No gönderilen GSM numarası bilgisi Status ise MMS’in durumunu bildirir.

• Status 1; iletilmedi

• Status 2; Turkcell’e gönderildi beklemede

• Status 0; iletildi anlamına gelir.
  

Tarih Aralığında Raporlama (getReport)

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<getReport xmlns="http://gateway.mobilus.net/mms/">
<UserName>test</UserName>
<CompanyCode>mb1000</CompanyCode>
<Password>1234</Password>
<SDate>2012-01-01</SDate>
<EDate>2012-01-31</EDate>
</getReport>
</soap:Body>
</soap:Envelope>

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.
CompanyCode: Mobildev SMS heasbına bağlı olduğunuz kanal kodunuzu ifade eder.
SDate: Raporun başlangıç tarihini ifade eder. Geçerli format yyyy-mm-dd hh:mm:ss.ms Örnek: 2012-10-01 13:59:59.000

EDate: Raporun bitiş tarihini ifade eder. Geçerli format yyyy-mm-dd hh:mm:ss.ms Örnek: 2012-10-01 13:59:59.000

Hata Kodları

ASP Scripti

C# Project