GittiGidiyor
GittiGidiyor API

Product Service

İstekte bulunan kurumsal kullanıcının bu servis ile gerçekleştirebileceği işlemler şunlardır: Bireysel GittiGidiyor hesabındaki ürünlerin detay bilgilerine erişme, yeni ürün girişi, mevcut ürünü güncelleme, ürün kopyalama, ürün silme, erken bitirme, listeleme servisi altındaki yeni listelenen ürün listesini alma, listeleme servisi ve revizyon ücreti hesaplatma, listeleme ücreti ödeme.

getProductsByIds

Birden fazla ürün ile ilgili detay bilgilere ulaşmak için kullanılır. Ürünlere girilen bütün bilgilerin detayları bu method ile kontrol edilebilir.



İzin Hakları:

Bu metodun güvenliği için sadece http protokolünün temel doğrulama (basic authentication) metodu kullanılır. Web servis çağırımlarında kullanıcılar kendi kullanıcı adlarını ve parolalarını kullanmalıdırlar. Ayrıca, kurumsal servis katmanında -servislere erişim esnasında- diğer katmanlarda olduğu gibi uygulama anahtarı, istek imzası ve o anki zaman değeri yollanarak istek (request) başına doğrulama gerçekleşir.



Erişim:

WSDL Adresi:https://dev.gittigidiyor.com:8443/listingapi/ws/IndividualProductService?wsdl


Servis Metot İmzası:

ProductServiceResponse getProductByIds(String apiKey, String sign, Long time, IntArray productIdList, StringArray itemIdList, Boolean withData, String lang);


İstek Parametreleri:

apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    İşlemin gerçekleştirildiği zaman.
ProductIdList
    İşlem yapılacak ürünlerin liste alanı
ItemIdList
    Ürün numaralarını girilmesi gereken alan
withData: boolean
    true: Listelenen ürünler detay bilgileri ile birlikte listelenir.
    false: Sadece ürün anahtarları(id) listelenir.
lang: String
    Olası bir hata anında dönen hata mesajının dilini belirtmek için kullanılır.

    Hata mesajı lang=tr ise Türkçe,
    lang=en ise İngilizce olarak çıkar.


Örnek İstek:

<prod:getProductsByIds>
   <apiKey>jY75vdDdDd9kjggjTh5uRJXwUBCKnnfU</apiKey>
   <sign>69272b931389cbec012b64476ec56aea</sign>
   <time>1585031347199</time>
   <productIdList>
      <item>541526402</item>
   </productIdList>
   <itemIdList>
   </itemIdList>
   <withData>true</withData>
   <lang>tr</lang>
</prod:getProductsByIds>


Sonuç Parametreleri:

apiKey: String
    Uygulamanızın anahtarı.
sign: String
    Uygulamanın o anki isteğinin imzası.
time: long
    İşlemin gerçekleştirildiği zaman.
ProductId int
    İlgili ürünün ürün numarası
ProductCount int
    Ürünün stok adeti
categoryCode String
    Ürünün kategori kodu
title String
    Ürünün başlığı
specs String
    Ürünün özellikleri
photos String
    Ürüne girilen fotoğraf linkleri
description String
    Ürün açıklaması
catalogID int
    Katalog özelliği bulunan ürünler için gerekli olan katalog numarası
Format String
    Ürünün satış formatı.Sabit Fiyat "F" Mağaza Forması "S" ile temsil edilir.
buyNowPrice double
    Ürünün satış fiyatı 
listingDays int
    Ürünün satışta kalacağı süre. 
cargoDetail String
    Kargo bilgilerinin girileceği alanı tanımlamak için kullanılır
city int
    Ürünün kargolayacağınız şehri belirtir. 
CargoCompanies String
    Kullanmak istediğiniz kargo firmalarının listesini belirtmek için kullanılır.
cargoCompany String
    Kargo firmanızının ismi küçk harflerle girilir. Sistemde olmayan bir kargo firmasını kullanmak isterseniz other kullanabilirsiniz. 
shippingPayment String
    Kargo ücretini ödeyecek tarafı belirtir.
shippingWhere String
    Ürünün hangi alan içerisinde kargolanacağını belirtir.
shippingtime String
    Ürünün kargoya verileceği süre
boldOption boolean
    Üründe kalın yazı kullanıp kullanılmayacağını belirtir
catalogOption boolean
    Üründe katalog özelliğinin kullanıp kullanılmayacağını belirtir.
vitrineOption boolean
    Üründe vitrin özelliğinin kullanıp kullanılmayacağını belirtir.
summary String
    Ürünün şuanki durumunu belirtir.
lang: String
    Olası bir hata anında dönen hata mesajının dilini belirtmek için kullanılır.

    Hata mesajı lang=tr ise Türkçe,
    lang=en ise İngilizce olarak çıkar


Örnek Sonuç:

      <prod:getProductsByIdsResponse xmlns:prod="https://product.individual.ws.listingapi.gg.com">
         <return>
            <ackCode>success</ackCode>
            <responseTime>24/03/2020 09:32:55</responseTime>
            <timeElapsed>26 ms</timeElapsed>
            <productCount>1</productCount>
            <products>
               <product>
                  <productId>541526402</productId>
                  <product>
                     <categoryCode>cpcd</categoryCode>
                     <storeCategoryId>0</storeCategoryId>
                     <title>ggtest deneme api</title>
                     <specs>
                        <spec required="false" value="2 Stories" name="Marka"/>
                        <spec required="false" value="Ahşap" name="Malzeme"/>
                        <spec required="false" value="Akçaağaç" name="Renk"/>
                        <spec required="false" value="Yok" name="Çekmece"/>
                        <spec required="false" value="Var" name="Ayna"/>
                        <spec required="false" value="50 cm-55 cm" name="Genişlik"/>
                        <spec required="false" value="90 cm-95 cm" name="Yükseklik"/>
                        <spec required="false" value="36 cm-40 cm" name="Derinlik"/>
                        <spec required="false" value="Sıfır" name="Durum"/>
                     </specs>
                     <photos>
                        <photo photoId="0">
                           <url>https://mcdn01.gittigidiyor.net/54152/541526402_0.jpg</url>
                        </photo>
                     </photos>
                     <pageTemplate>4</pageTemplate>
                     <description><![CDATA[<body>
 <p><span style="background-color:rgb(255, 255, 204); color:rgb(120, 120, 120); font-family:arial,helvetica,sans-serif; font-size:11.004px">Ürün yeni mi, kullanılmış mı veya garantisi devam ediyor mu? Herhangi bir tamir veya onarım gördü mü?</span></p>
</body>]]></description>
                     <catalogId>0</catalogId>
                     <catalogDetail>0</catalogDetail>
                     <format>F</format>
                     <buyNowPrice>1.0</buyNowPrice>
                     <listingDays>10</listingDays>
                     <productCount>1</productCount>
                     <cargoDetail>
                        <city>34</city>
                        <cargoCompanies>
                           <cargoCompany>other</cargoCompany>
                        </cargoCompanies>
                        <shippingPayment>S</shippingPayment>
                        <shippingWhere>city</shippingWhere>
                        <cargoCompanyDetails>
                           <cargoCompanyDetail>
                              <name>other</name>
                              <value>Diğer</value>
                           </cargoCompanyDetail>
                        </cargoCompanyDetails>
                        <shippingTime>
                           <days>2-3days</days>
                        </shippingTime>
                     </cargoDetail>
                     <affiliateOption>false</affiliateOption>
                     <boldOption>false</boldOption>
                     <catalogOption>true</catalogOption>
                     <vitrineOption>false</vitrineOption>
                  </product>
                  <summary>
                     <listingStatus>L</listingStatus>
                  </summary>
               </product>
            </products>
         </return>
      </prod:getProductsByIdsResponse>