Videocell API

Çözüm Kodu: videocell

Video Cell servisimizi kullanarak Toplu Video gönderimi yapmak isteyen yazılım geliştiricilerin, sistemimize entegre olmaları için Videocell API geliştirme aracı hazırlanmıştır.

Sistem Gereksinimleri

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

Windows 98 SE, ME, 2000, XP, Vista, Windows 7, UNIX, Linux ya da MAC OS İşletim Sistemi
Internet Explorer 6 SP1 (Windows platformu için)

Kullanmaya Başlamak

Kendi çözümünüz içerisinden API'lerimizi kullanarak Video gönderimi yapabilirsiniz. API’lerimizi kullanmaya başlamak için sayfanın sağında bulunan "Başvur" linkine tıklayınız.

Linkler

. Kullanım Kılavuzu
. Başvur

Yayınlama Tarihi: 28.09.2011

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

Yazılım geliştiriciler, http://gateway.mobilus.net/video/videoapi.asmx adresini kullanarak servise erişebilirler.

Uyarılar

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

Mesaj içeriğinde Türkçe karakterler, LineFeed, Enter, Tab, “~”,”€” gibi karakterler bulunmamalıdır.

GSM Numaraları 05321234567, 5321234567,905321234567 şeklinde olmalıdır.

Mobildev Web Servisi Toplu Video gönderimleri için tasarlanmış bir çözümdür. Yollanacak mesajlar mümkün olduğunca tek bir seferde Web Servisine iletilmelidir.

Hata Kodu	Açıklama
01	Hatalı kullanıcı adı, parola veya bayi kodu bilgisi
02	Konu (subject) alanı boş bırakılamaz
03	Konu (subject) alanı 100 karakterden uzun olamaz
04	SMS gönderimi için herhangi bir GSM numarası bilgisi gönderilmemiş
05	Yetersiz kredi
06	Dosya adı alanı boş bırakılamaz
07	Dosya tipi .3gp olmalıdır
08	Dosya gönderimi yapılmamış
09	Dosya boyutu en fazla 2 MB olabilir
10	Dosya oluşturma işlemi esnasında bir hata oluştu. Dosyanızın uygun formatta ve doğru işlendiğine emin olunuz
11	Hatalı gönderen (originator) bilgisi
12	Belirtilen packetId sistemde bulunamadı veya henüz işlenmedi
13	Gönderilen FDate veya Sdate hatalı veya boş bırakılmış uygun format 2010-05-06’dır. (Yıl-Ay-Gün)
14	Belirtilen tarihler arasında herhangi bir gönderiminiz bulunmamaktadır
15	Tanımlanamayan hata

public string getInfo (string username, string companycode, string password)

Parametre Değerleri

Parametre Değerleri	Açıklama
String username	Mobildev’de tanımlı kullanıcı adınız
String companycode	Mobildev’de sistemlerinde bağlı olduğunuz kanal kodu
String password	Mobildev’de tanımlı kullanıcı adınıza ait parola bilgisi

Örnek SOAP Verisi

Geri dönüş değeri olarak eğer işlem başarılı ise:

Kredi sayısı<10>
Originator1<10>
Originator2<10>
OriginatorN

Eğer hata oluşmuş ise bkz. Hata kodları

Geri dönüş değerlerinde bulunan <10> LineFeed karakterini temsil etmektedir. Originator bilgisi SMS gönderimlerinizde hedef GSM numarasının “Gönderen” kısmında çıkacak olan bilgiyi ifade etmektedir. Bu bilgi 11 karakterlik nümerik ya da alfanümerik karakterlerden oluşan (Türkçe ve &, <, > gibi özel karakterler içermeyen) bir ifade olabilir.

Geri Dönüş SOAP Verisi

Mobildev Video Servisi Video Gönderimi için iki farklı fonksiyon sunmaktadır. Bunlar;

sendVideo; bu metot sayesinde bir video dosyasını aynı konu başlığı altında bir veya birden fazla GSM numarasına göndermenize olanak sağlar.

sendVideoMultiSender; bu metot sayesinde bir video dosyasını farklı konu başlıkları ile farklı GSM numaralarına göndermenize olanak sağlar.

Video Gönderme (SendVideo)

public string sendVideo(string username, string companycode, string password, string subject,
string gsmnos, string originator, string sdate, string fileName, byte[] fileBytes)

Parametre Değerleri

Parametre Değerleri	Açıklama
String username	Mobildev’de tanımlı kullanıcı adınız
String companycode	Mobildev’de sistemlerinde bağlı olduğunuz kanal kodu
String password	Mobildev’de tanımlı kullanıcı adınıza ait parola bilgisi
String subject	Gönderilecek olan videoya ait konu bilgisi
String gsmnos	Videonun gönderileceği GSM numarası bilgisi, birden fazla kişiye gönderebilmek için numaraları virgül (“,”) ile ayırabilirsiniz.
String originator	Mesajın gönderildiği GSM numarasında gönderen kısmında çıkacak ifade
String sdate	Mesajın gönderileceği tarih bilgisi eğer bu alan boş bırakılırsa mesaj hemen gönderilir, geçerli tarih formatı: 060520101611 ggaayyyyssdd (GünAyYılSaatDakika)
String fileName	Gönderilecek videonun dosya adı örn: “ornek.3gp”
Byte[] fileBytes	Gönderilecek dosyanın byte halidir. Net örnek olarak kısacaSystem.IO.File.ReadAllBytes("C:\video\ornek.3gp")dır. Dosya boyutu en fazla 2 MB olabilir.

Örnek SOAP Verisi

Geri dönüş değeri olarak işlem başarılı ise “ID: 123456” şeklinde mesaj gönderim paketine ait TimerID bilgisi döner.

Eğer işlem hatalı ise bkz. Hata kodları

Geri Dönüş SOAP Datası

Video Gönderme (sendVideoMultiSender)

public string sendVideoMultiSender(string username, string companycode, string password,
SMSInfo[] smsInfoArray, string originator, string sdate, string fileName, byte[] fileBytes)

Parametre Değerleri	Açıklama
String username	Mobildev’de tanımlı kullanıcı adınız
String companycode	Mobildev’de sistemlerinde bağlı olduğunuz kanal kodu
String password	Mobildev’de tanımlı kullanıcı adınıza ait parola bilgisi
SMSInfo[] smsInfoArray	SMSInfo objesi bir paket içerisinde aynı videoyu farklı konu başlıkları ile GSM Numaralarına göndermek için kullanılır, subject ve GSM field’larından oluşmaktadır.
String originator	Mesajın gönderildiği GSM numarasında gönderen kısmında çıkacak ifade
String sdate	Mesajın gönderileceği tarih bilgisi eğer bu alan boş bırakılırsa mesaj hemen gönderilir, geçerli tarih formatı: 060520101611 ggaayyyyssdd (GünAyYılSaatDakika)
String fileName	Gönderilecek videonun dosya adı örn: “ornek.3gp”
Byte[] fileBytes	Gönderilecek dosyanın byte halidir. Net örnek olarak kısaca System.IO.File.ReadAllBytes("C:\video\ornek.3gp")dır. Dosya boyutu en fazla 2 MB olabilir.

Örnek SOAP Verisi

Geri dönüş değeri olarak işlem başarılı ise “ID: 123456” şeklinde mesaj gönderim paketine ait TimerID bilgisi döner. Eğer işlem hatalı ise bkz. Hata kodları

Geri Dönüş SOAP Datası

Mobildev Web Servisi gönderilen video mesajlarının raporlanması için iki çeşit raporlama seçeneği sunmaktadır.

Tarih arası raporlama (reportbyDate)

Gönderilen mesaj paketine göre sorgulama (reportbyId)

Tarih Arası Raporlama (reportByDate)

public string reportByDate(string username, string companycode, string password, string FDate, string LDate)

Parametre Değerleri	Açıklama
String username	Mobildev’de tanımlı kullanıcı adınız
String companycode	Mobildev’de sistemlerinde bağlı olduğunuz kanal kodu
String password	Mobildev’de tanımlı kullanıcı adınıza ait parola bilgisi
String FDate	Raporun başlangıç tarihini gösterir. Örn: 2010-05-05
String LDate	Raporun bitiş tarihini gösterir. Örn: 2010-05-06

Örnek SOAP Verisi

Geri Dönüş SOAP Verisi

Geri dönüş değeri başarılı ise

“TimerID”<32>“GSM NO”<32>”Durum”<32>”İzlenme Durumu”<32>”izlenme tarihi”

Şeklinde örnek: 5.6.1.1.’e bakınız.

1234<32>05321234567<32>2<32>0<32><10>
1234<32>05321234568<32>2<32>1<32>2010-05-06 16:30<10>

Not: Durum bilgisinde “1”; mesajın beklemede olduğunu, “2”; mesajın iletildiğini, “3”; mesajın iletilemediğini belirtmektedir. İzlenme durumda “0”; videonun henüz izlenmediğini, “1” ise videonun izlendiğini belirtmektedir. İzlenme durumu 0 iken, izlenme tarihi boş gelecektir. Video eğer izlenmiş ise izlenme tarihi YIL-AY-GÜN SAAT-DAKİKA şeklinde gelecektir. Geri dönüş değerinde bulunan <32> boşluk karakterini, <10> LineFeed karakterini ifade etmektedir.

Geri dönüş değeri hatalı ise bkz. Hata kodları

Gönderilen Mesaj Paketine Göre Raporlama (reportById)

public string reportById(string username, string companycode, string password, string packetid)

Parametre Değerleri	Açıklama
String username	Mobildev’de tanımlı kullanıcı adınız
String companycode	Mobildev’de sistemlerinde bağlı olduğunuz kanal kodu
String password	Mobildev’de tanımlı kullanıcı adınıza ait parola bilgisi
String packetID	Gönderdiğiniz mesaj paketine ait TimerID (paket ID) bilgisi

Örnek SOAP Verisi

Geri Dönüş SOAP Verisi

Geri dönüş değeri başarılı ise

“TimerID”<32>“GSM NO”<32>”Durum”<32>”İzlenme Durumu”<32>”izlenme tarihi”

Şeklinde örnek: 5.6.1.1.’e bakınız.

1234<32>05321234567<32>2<32>0<32><10>
1234<32>05321234568<32>2<32>1<32>2010-05-06 16:30<10>

Not: Durum bilgisinde “1”; mesajın beklemede olduğunu, “2”; mesajın iletildiğini, “3”; mesajın iletilemediğini belirtmektedir. İzlenme durumda “0”; videonun henüz izlenmediğini, “1” ise videonun izlendiğini belirtmektedir. İzlenme durumu 0 iken, izlenme tarihi boş gelecektir. Video eğer izlenmiş ise izlenme tarihi YIL-AY-GÜN SAAT-DAKİKA şeklinde gelecektir. Geri dönüş değerinde bulunan <32> boşluk karakterini, <10> LineFeed karakterini ifade etmektedir.

Geri dönüş değeri hatalı ise bkz. Hata kodları

Kütüphane

Bu Sayfalarda Size;

Bu Sayfalarda Size;

Bu Sayfalarda Size;

Bu Sayfalarda Size;

Bu Sayfalarda Size;

Bu Sayfalarda Size;

Bu Sayfalarda Size;

Bu Sayfalarda Size;

Videocell API

Çözüm Kodu: videocell

Video Cell servisimizi kullanarak Toplu Video gönderimi yapmak isteyen yazılım geliştiricilerin, sistemimize entegre olmaları için Videocell API geliştirme aracı hazırlanmıştır.

Sistem Gereksinimleri

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

Windows 98 SE, ME, 2000, XP, Vista, Windows 7, UNIX, Linux ya da MAC OS İşletim Sistemi

Internet Explorer 6 SP1 (Windows platformu için)

Kullanmaya Başlamak

Kendi çözümünüz içerisinden API'lerimizi kullanarak Video gönderimi yapabilirsiniz. API’lerimizi kullanmaya başlamak için sayfanın sağında bulunan "Başvur" linkine tıklayınız.

Linkler

. Kullanım Kılavuzu. Başvur

Yayınlama Tarihi: 28.09.2011

Etiketler:

Uyarılar

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

Mesaj içeriğinde Türkçe karakterler, LineFeed, Enter, Tab, “~”,”€” gibi karakterler bulunmamalıdır.

GSM Numaraları 05321234567, 5321234567,905321234567 şeklinde olmalıdır.

Mobildev Web Servisi Toplu Video gönderimleri için tasarlanmış bir çözümdür. Yollanacak mesajlar mümkün olduğunca tek bir seferde Web Servisine iletilmelidir.

Hata Kodu

Açıklama

01

Hatalı kullanıcı adı, parola veya bayi kodu bilgisi

02

Konu (subject) alanı boş bırakılamaz

03

Konu (subject) alanı 100 karakterden uzun olamaz

04

SMS gönderimi için herhangi bir GSM numarası bilgisi gönderilmemiş

05

Yetersiz kredi

06

Dosya adı alanı boş bırakılamaz

07

Dosya tipi .3gp olmalıdır

08

Dosya gönderimi yapılmamış

09

Dosya boyutu en fazla 2 MB olabilir

10

Dosya oluşturma işlemi esnasında bir hata oluştu. Dosyanızın uygun formatta ve doğru işlendiğine emin olunuz

11

Hatalı gönderen (originator) bilgisi

12

Belirtilen packetId sistemde bulunamadı veya henüz işlenmedi

13

Gönderilen FDate veya Sdate hatalı veya boş bırakılmış uygun format 2010-05-06’dır. (Yıl-Ay-Gün)

14

Belirtilen tarihler arasında herhangi bir gönderiminiz bulunmamaktadır

15

Tanımlanamayan hata

public string getInfo (string username, string companycode, string password)

Parametre Değerleri

Parametre Değerleri

Açıklama

String username

Mobildev’de tanımlı kullanıcı adınız

String companycode

Mobildev’de sistemlerinde bağlı olduğunuz kanal kodu

String password

Mobildev’de tanımlı kullanıcı adınıza ait parola bilgisi

Örnek SOAP Verisi

Geri dönüş değeri olarak eğer işlem başarılı ise:

Kredi sayısı<10> Originator1<10> Originator2<10> OriginatorN

Eğer hata oluşmuş ise bkz. Hata kodları

Geri Dönüş SOAP Verisi

Mobildev Video Servisi Video Gönderimi için iki farklı fonksiyon sunmaktadır. Bunlar;

sendVideo; bu metot sayesinde bir video dosyasını aynı konu başlığı altında bir veya birden fazla GSM numarasına göndermenize olanak sağlar.

sendVideoMultiSender; bu metot sayesinde bir video dosyasını farklı konu başlıkları ile farklı GSM numaralarına göndermenize olanak sağlar.

Video Gönderme (SendVideo)

public string sendVideo(string username, string companycode, string password, string subject, string gsmnos, string originator, string sdate, string fileName, byte[] fileBytes)

Parametre Değerleri

. Kullanım Kılavuzu
. Başvur

Kredi sayısı<10>
Originator1<10>
Originator2<10>
OriginatorN

public string sendVideo(string username, string companycode, string password, string subject,
string gsmnos, string originator, string sdate, string fileName, byte[] fileBytes)