Interprise. Ülker İletişim Web Servisi. Bu doküman Ülker iletişim web servisi hakkında teknik açıklamaları içerir. İletişim web servisi web adresi :

Transkript

1 Ülker İletişim Web Servisi Interprise Bu doküman Ülker iletişim web servisi hakkında teknik açıklamaları içerir. İletişim web servisi web adresi : projelerinde Add Web Reference seçeneği ile yukarıdaki web adresi belirtilerek servis proje içine dahil edilir. Web servisinin kullanılabilmesi için iki adet güvenlik kodu gereklidir. 1.Ajans güvenlik kodu 2.İletişim web servisi güvenlik kodu Bu bilgilere erişmek için adresinden sizinle paylaşılan kullanıcı adı ve parola ile giriş yaptıktan sonra API/Export linkine tıklandığında Yetkiniz dahilinde erişebileceğiniz siteler görüntülenir. Ayarlar linkine tıklandığında

2 İletişim web servisinde kullanmanız gereken Ajans güvenlik kodu (Agency Secret Key) ve İletişim web serivisi Güvenlik Kodu (İletişim Secret Key) değerlerine erişebilirsiniz. Aynı sayfanın altında iletişim formu alanları ile ilgili bölüm mevcuttur. Bu bölümde iletişim formunda kullanılacak olan alanları işaretleyip, doldurulması zorunlu alan olup olmamasını belirleyebilirsiniz. Form alanları içinde isim, mesaj ve e-posta mutlaka olmalıdır. Bu nedenle zorunlu alan statüsü değiştirilemez. Seçimler yapıldıktan sonra Kaydet butonuna basılarak panelden yapılması gereken değişiklikler tamamlanmış olur.

3 Web Servisi Dokümantasyonu Nesneler IletisimBilgiOrnegi ProjectContactSecretKey Proje güvenlik kodunu içeren string AgencySecretKey Ajans güvenlik kodunu içeren string yonlendirensiteid :string Başka bir siteden iletişim formuna yönlendirme yapıldığında kullanılır. sitedomain Site domain bilgisini içeren string Örnek : siteadi Site adını içeren string uyeid Üyelik bilgisi web servisine gönderildiğinde kullanılır. kisituruid Formu dolduran kişi hakkında bilgi içerir. Varsayılan değer :1 Seçenekler :1-Tüketici, 2-Perakandeci, 5-Kurum Organizasyon konuid İletinin konusu hakkında bilgi verir. Varsayılan değer:0 getkonularbydilid fonksiyonu ile konu listesine erişilebilir.

4 1:Ürün, 2:Satış Teşkilatı,4:Kampanya,8:Reklam, 16: Sponsorluk,16384:Diğer aciklama İleti içeriğini içerir. isim Gönderen kişinin adını ve soyadını içerir. Ad ve Soyadın tek bir alana yazılacağı alandır. MusteriAdi Gönderen kişinin adını içeren alandır. MusteriSoyadi Gönderen kişinin soyadını içeren alandır. eposta Gönderen kişi e-posta adresini içerir. kurulusadi Gönderen kişi firma adını içerir. Varsayılan değer boştur. ulkeid Ülke Id değerini içerir. Rakamdan oluşur. getulkeler fonksiyonu ile şehir listesine erişilebilir. ilid Şehir Id değerini içerir.rakamdan oluşur. getiller fonksiyonu ile şehir listesine erişilebilir. ildiger Listede olmayan bir şehir için metin alanından girilen şehir bilgisini içerir.

5 ilceid İlçe Id değerini içerir. getilcelerbyilid fonksiyonu ile bir ile ait olan ilçe listesi elde edilir. adresturid Adres türünü içerir. getadresturleri fonksiyonu ile elde edilebilir. Varsayılan değer: 1 Seçenekler :1-Ev, 2-İş, 3-Yazlık Adres Adres bilgisini içerir. telefon1turid Telefon alanını tanımlar. Varsayılan değer:1 Seçenekler :1-Ev, 2-İş, 3-Cep, 4-Faks telefon1ulkekodu Ülke kodunu içerir. Zorunlu değildir. telefon1alankodu Üç haneli alan kodunu içeren rakamlardan oluşan string. telefon1numara 7 haneli telefon numarasını içeren rakamlardan oluşan string. telefon2turid Formdaki ikinci telefon alanı olduğunda kullanılabilir. telefon2ulkekodu Formdaki ikinci telefon alanı olduğunda kullanılabilir. telefon2alankodu Formdaki ikinci telefon alanı olduğunda kullanılabilir.

6 telefon2numara Formdaki ikinci telefon alanı olduğunda kullanılabilir. ip Mesajı gönderen kişinin IP numarası gönderilmelidir. dilid Form kontrollerinde hata olduğunda hata mesajları Türkçe ve İngilizce olarak görüntülenebilmektedir. Varsayılan değer :1 Seçenekler :1-Türkçe, 2-İngilizce action İleti ile ilgili alınacak aksiyon belirtilir. Atama yapılmayabilir. cocuk1isim Çocuk isim bilgisini içerir.gerektiğinde kullanılabilir. cocuk1cinsiyet Çocuk cinsiyet bilgisini içerir.gerektiğinde kullanılabilir. cocuk1dogumtarihi Çocuk doğum tarihi bilgisini içerir.gerektiğinde kullanılabilir. cocuk2isim Çocuk isim bilgisini içerir.gerektiğinde kullanılabilir. cocuk2cinsiyet Çocuk cinsiyet bilgisini içerir.gerektiğinde kullanılabilir. cocuk2dogumtarihi Çocuk doğum tarihi bilgisini içerir.gerektiğinde kullanılabilir. cocuk3isim Çocuk isim bilgisini içerir.gerektiğinde kullanılabilir.

7 cocuk3cinsiyet Çocuk cinsiyet bilgisini içerir.gerektiğinde kullanılabilir. cocuk3dogumtarihi Çocuk doğum tarihi bilgisini içerir.gerektiğinde kullanılabilir. smsgonderilsinmi Sms gönderilip gönderilmemesini belirler. epostagonderilsinmi E-posta gönderilip gönderilmemesini belirler mektupgonderilsinmi Mektup gönderilip gönderilmemesini belirler dogumtarihi Gönderici doğum tarihi içerir. Gerektiğinde kullanılabilir. calisiyormu Gerektiğinde kullanılabilir. bebekbekliyormu Gerektiğinde kullanılabilir. yas Yaş bilgisini içerir. iletisim_sonuc Gönder fonksiyonu ile form bilgileri gönderildiğinde web servisinden döner. Sonuc 0: Mesaj gönderilemezse döner 1: Mesaj başarıyla gönderildiğinde döner 2: Güvenlik kodları ya da form geçerlilik denetimleri ile ilgili sorun olduğunda döner.

8 Aciklama Hata mesajı ile ilgili açıklama ya da mesajın ulaştığı bilgisi döner. Mesajlar MessageInfo nesnesi tipinde üye MessageInfo Mesajlar Validasyon hatası olduğunda bu hataları içeren dizi. MessageCode Validasyon hatası olduğunda bu hata kodlarını döndüren dizi. ContactResultInfo Gönder fonksiyonuna parametre olarak gönderilir. Sonuc Validasyon hatası olduğunda bu hataları içeren dizi. Mesajlar Validasyon hatası olduğunda bu hata kodlarını döndüren dizi. Fonksiyonlar Gonder İletişim formundaki bilgilerin gönderilmesini sağlar. Parametreler: IletisimBilgiOrnegi ContactResultInfo Dönen Değer: iletisim_sonuc

9 getadresturleri Adres seçeneklerini döndürür. Parametreler:Yok Dönen Değer:Dataset getilcelerbyilid Şehire ait ilçe listesini döndürür. Parametreler: ilid Dönen Değer:Dataset getiller Şehir listesini döndürür. Parametreler:Yok Dönen Değer:dataset getkonularbydilid Mesaj konu listesini döndürür. Parametreler:DilId Türkçe:1,İngilizce:2 Dönen Değer:dataset getnumaraturleri Telefon numara türlerini döndürür. Parametreler:Yok Dönen Değer:Dataset getulkeler Ülke listesini döndürür. Parametreler:Yok Dönen Değer: Dataset getulkeleringilizce İngilizce ülke listesini döndürür. Parametreler:Yok, Dönen Değer:Dataset

10 Örnek ASP.NET Sayfa Kodu Asp.Net vb ile yazılmış kod örneği aşağıdadır.web form yerine flash form kullanıldığında post edilen değerler Request.Form( AlanAdi ) şeklinde alınarak web servisine aktarılabilir. Partial Class iletisim Inherits System.Web.UI.Page Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load If Not Page.IsPostBack Then ListeKutulari() End If End Sub Public Sub ListeKutulari() Dim iletisim As New yenimbs.contactservice '/////////// Şehir Listesi //////////// ddlsehir.datasource = iletisim.getiller ddlsehir.datatextfield = "AD" ddlsehir.datavaluefield = "ID" ddlsehir.databind() ddlsehir.items.insert(0, New ListItem("İl Seçiniz...", "")) '/////////// Telefon Türleri //////////// ddltelefontipi1.datasource = iletisim.getnumaraturleri() ddltelefontipi1.datatextfield = "AD" ddltelefontipi1.datavaluefield = "ID" ddltelefontipi1.databind() ddltelefontipi1.items.insert(0, New ListItem(" ", "")) End Sub Protected Sub imgbtngonder_click(byval sender As Object, ByVal e As System.Web.UI.ImageClickEventArgs) Handles imgbtngonder.click If Page.IsValid Then MesajGonder() End If End Sub Public Sub MesajGonder() Dim IPAddress As String = Request.UserHostAddress Dim iletisim As New yenimbs.contactservice Dim iletisimdata As New yenimbs.iletisimbilgiornegi Dim iletisimsonuc As New yenimbs.iletisim_sonuc Dim iletisimsonucbilgi As New yenimbs.contactresultinfo iletisimdata.agencysecretkey = " " iletisimdata.projectcontactsecretkey = " " iletisimdata.ip = IPAddress iletisimdata.aciklama = txtmesaj.text iletisimdata.dilid = 1 iletisimdata.eposta = txteposta.text iletisimdata.isim = txtadsoyad.text iletisimdata.musteriadi = txtad.txt

11 iletisimdata.musterisoyadi = txtsoyad.txt iletisimdata.ilid = ddlsehir.selectedvalue iletisimdata.siteadi = "site adı" iletisimdata.sitedomain = " iletisimdata.telefon1ulkekodu = txtulkekodu1.text iletisimdata.telefon1alankodu = txtsehirkodu1.text iletisimdata.telefon1numara = txttelefonno1.text iletisimdata.telefon1turid = ddltelefontipi1.selectedvalue iletisimdata.ilceid = ddlilce.selectedvalue iletisimsonuc = iletisim.gonder(iletisimdata, iletisimsonucbilgi) Select Case iletisimsonuc.sonuc Case 0 'Teknik Sorun, mesaj gönderilemedi Case 1 'Mesaj gönderildi Case 2 'Form validasyonları ya da güvenlik kodu hatalı End Select End Sub Public Sub IlceSec() Dim iletisim As New yenimbs.contactservice ddlilce.datasource = iletisim.getilcelerbyilid(ddlsehir.selectedvalue) ddlilce.datatextfield = "AD" ddlilce.datavaluefield = "ID" ddlilce.databind() ddlilce.items.insert(0, New ListItem("İlçe Seçiniz ", "")) End Sub Protected Sub ddlsehir_selectedindexchanged(byval sender As Object, ByVal e As System.EventArgs) Handles ddlsehir.selectedindexchanged IlceSec() End Sub End Class Örnek PHP Kod <?php /*Php ayarları **********************************************************************************/ error_reporting(e_all & ~E_NOTICE); ini_set('extension', 'php_soap.dll' ); ini_set('display_errors',1); ini_set("soap.wsdl_cache_enabled","0"); /**Servis Ayarları & Adresi ve Bağlantısı *********************************************************************************/ $cservice = new SoapClient(" // $cservice = new SoapClient(" $all_fields = array_map(function($n){return '';}, array_flip(array('projectcontactsecretkey', 'AgencySecretKey', 'yonlendirensiteid', 'sitedomain', 'siteadi', 'uyeid', 'kisituruid', 'konuid', 'aciklama', 'isim', 'MusteriAdi', 'MusteriSoyadi', 'eposta', 'kurulusadi', 'ulkeid', 'ilid', 'ildiger', 'ilceid', 'adresturid', 'adres', 'telefon1turid', 'telefon1ulkekodu',

12 'telefon1alankodu', 'telefon1numara', 'telefon2turid', 'telefon2ulkekodu', 'telefon2alankodu', 'telefon2numara', 'ip', 'dilid', 'action', 'cocuk1isim', 'cocuk1cinsiyet', 'cocuk1dogumtarihi', 'cocuk2isim', 'cocuk2cinsiyet', 'cocuk2dogumtarihi', 'cocuk3isim', 'cocuk3cinsiyet', 'cocuk3dogumtarihi', 'smsgonderilsinmi', 'epostagonderilsinmi', 'mektupgonderilsinmi', 'dogumtarihi', 'calisiyormu', 'bebekbekliyormu', 'yas'))); $arrayservissettings=array( "ProjectContactSecretKey" => "f3674d f-a9fe-84732f99b1dd", "AgencySecretKey" => "f f71b-40d0-8b31-21bb2fa77031", //"iletisimsecretkey" => "1fbd8958-a44a-4cd8-8e71-b8edb19a3db0", //Site ayarları 'yonlendirensiteid' => 198, 'sitedomain' => " 'siteadi' => "Şok Marketler", 'uyeid' => 198, 'ip' => (string)$_server['remote_addr'] ); /*****************************************************************************************/ if(isset($_get['ilceid'])){ header("last-modified: ". gmdate( "D, d M Y H:i:s" ). "GMT"); header("cache-control: no-cache, must-revalidate"); header("pragma: no-cache"); header("content-type: application/json"); header('content-type: application/javascript'); $ilcelerlist=$cservice->getilcelerbyilid(array("ilid"=>$_get['ilceid'])); //var_dump_mono($ilcelerlist->getilcelerbyilidresult->any); $xml=$ilcelerlist->getilcelerbyilidresult->any; $ilcelerlist = new SimpleXMLElement($xml); $ilcelerlistjsonarray=array();

13 foreach($ilcelerlist->newdataset->table1 as $ilce){ } $ilcelerlistjsonarray[]=array('id'=> trim($ilce->id), 'ad' =>trim($ilce->ad)); // var_dump_mono($ilcelerlistjsonarray); echo json_encode($ilcelerlistjsonarray); exit; } /*****************************************************************************************/ $illerlist=$cservice->getiller(); $xml=$illerlist->getillerresult->any; $illerlist = new SimpleXMLElement($xml); $illerlist = $illerlist->newdataset->table1; //Gelen Datalar işleniyor******************************************************************************/ if(isset($_post["isim"])){ //-- $ContactResultInfo = array( // 'sonuc' => "0", 'mesajlar' => array() ); $iletisim_data = array( # override previous 'isim' => htmlspecialchars(trim($_post["isim"])), 'eposta' => htmlspecialchars(trim($_post["eposta"])), 'ilid' => (int)$_post["ilid"], 'ilceid' => (int)$_post["ilceid"],

14 'dilid' => 1, // (int)$_post["dilid"], 'telefon1turid' => (int)$_post["telefon1turid"], 'telefon1ulkekodu' => htmlspecialchars(trim($_post["telefon1ulkekodu"])), 'telefon1alankodu' => htmlspecialchars(trim($_post["telefon1alankodu"])), 'telefon1numara' => htmlspecialchars(trim($_post["telefon1numara"])), 'adres' => htmlspecialchars(trim($_post["adres"])), 'aciklama' =>htmlspecialchars(trim($_post["aciklama"])) ); $iletisim_data=array_merge($all_fields, $arrayservissettings, $iletisim_data); // var_dump_mono($all_fields); var_dump_mono($iletisim_data); $senddata = array( "ContactInfo" => $iletisim_data, "ContactResultInfo" => $ContactResultInfo ); //Veriler GÖnderiliyor... $iletisim_sonuc=""; var_dump_mono($senddata); $iletisim_sonuc=$cservice->gonder($senddata); } function var_dump_mono($arg, $printr=true) { echo "<pre>"; $printr? print_r($arg) : var_dump($arg); echo "</pre>"; }

15 //--?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" " <html xmlns=" <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <title>untitled Document</title> <script src=" <script> function selectadditems(tag,items,selected){ //Select dataları işleme... var select = tag ; $('option', select).remove(); if(select.prop) { var options = select.prop('options'); }else { var options = select.attr('options'); } $.each(items, function (key, value){ options[options.length] = new Option(value.ad, value.id); }); if(selected=!null){ select.val(selected);

16 } } function getilcelerlist(id){ //İlçe Listedi alınıyır... $.ajax({ url: 'contactform.php?ilceid='+id, datatype: 'json', success: function(json) { // alert(json); selectadditems($('#ilceid'),json,selected=null); } }); } $(document).ready(function(e) { /******************************/ $('#ilid').change(function(e) { getilcelerlist($('#ilid option:selected').val()); }); /******************************/ }); </script> </head> <body>

17 <form id="contactform" name="contactform" method="post" action=""> <p> <label>adınız</label> <input type="text" name="isim" id="isim" /> </p> <p> <label for="soyad">soyadınız</label> <input type="text" name="soyad" id="soyad" /> </p> <p> <label for="soyad">e-posta</label> <input type="text" name="eposta" id="eposta" /> </p> <p> <label for="il">il</label> <select name="ilid" id="ilid"> <option value="">il Seçiniz----</option> <?php foreach($illerlist as $il) { echo '<option value="'.$il->id.'">'.$il->ad.'</option>'; }?> </select> </p> <p> <div id="ilcesecimi" > <label for="ilce">ilçe</label> <select name="ilceid" id="ilceid" > <option value="">ilçe Seçiniz ---</option> </select> </div>

18 <div id="phone1" > <label for="telefon1turid">tel</label> <input type="text" name="telefon1turid" id="telefon1turid" value="1" /> <input type="text" name="telefon1ulkekodu" id="telefon1ulkekodu" value="90" /> <input type="text" name="telefon1alankodu" id="telefon1alankodu" value="216" /> <input type="text" name="telefon1numara" id="telefon1numara" value=" " /> </div> <div id="adress" > <label for="adres">adres</label> <input type="adres" name="adres" id="adres" value="deneme" /> </div> </p> <p> <label for="mesaj">mesajınız</label> <textarea name="aciklama" cols="50" rows="7" id="aciklama"></textarea> </p> <p> <input type="submit" name="sendbtn" id="sendbtn" value="gönder" /> </p> <p> </p> <p> </p> </form> <div class="boxinfo"> <?php var_dump_mono($iletisim_sonuc, false);?> </div> </body> </html>

19 Önemli Notlar Yönetim panelinden doğru güvenlik kodlarını aldığınıza emin olunuz. Üyelik web servisi ve iletişim web servisinde kullanılan il ve ilçe bilgileri (Id ler) birbirinden farklıdır. İletişim web servisi içindeki il ve ilçe listeleme fonksiyonunu kullanarak iletişim formunu oluşturunuz. Plaka kodlarıyla il bilgilerini kullanmayınız. Kendi oluşturduğunuz il ve ilçe id lerini kullanmayınız. Eğer servis exception verirse adresine mail ile bilgi veriniz. Doküman Tarihçesi İsmail Cem AKSOY, , Oluşturuldu İsmail Cem AKSOY, , Güncellendi Eşref Atak, , Güncellendi - PHP örnek kod eklendi