GittiGidiyor
GittiGidiyor API

Product Service

Bu metodda kullanıcıların güvenliği için http protokolünün temel doğrulama (basic authentication) metodu kullanılır. Bu doğrulama için gerekli bilgileri Api Anahtarları sayfanızdan kontrol edebilirsiniz. Web servis çağırımlarında kullanıcılar kendi kullanıcı adlarını ve role passwordlerini kullanmalıdırlar. Ayrıca, kurumsal servis katmanında işlem yapılır ise -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.

insertProduct

Gittigidiyor üzerinde ürün listelemek için bu metot kullanılır. Girilen ürün GittiGidiyor Bana Özel sayfasında "Yeni Listelenenler" bölümünde görünecektir.



İ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 insertProduct(String apiKey, String sign, long time,String itemId, ProductType productType, boolean forceToSpecEntry, boolean nextDateOption, 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.
itemId: String
    Satışa konulan ürünün entegrasyon yapan firma tarafındaki ürün tekil anahtarı.
product: ProductType
    Ürün bilgisini taşıyan nesne.
forceToSpecEntry: boolean
    true : Kategori bazlı spec girişi zorunlu
    false : Kategori bazlı spec girişi zorunlu değil
nextDateOption: boolean
    true: İleri tarih opsiyonu var. startDate belirlenmelidir.
    false: İleri tarih opsiyonu yok.
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:insertProduct>
   <apiKey>ueYeyn9fGV3xmXuZSm9gVzJCPwEE6NTn</apiKey>
   <sign>7c12f49d66da0567776488ef3675ca97</sign>
   <time>1290599997142</time>
   <itemId>101gdk</itemId>
   <product>
      <categoryCode>gdk</categoryCode>
      <storeCategoryId></storeCategoryId>
      <title>Kodak Z915 12MP</title>
      <subtitle></subtitle>
      <specs>
         <spec name="Durumu" value="Kullanılmış" type="Combo" required="true" />
         <spec name="Çözünürlük(Megapiksel)" value="10.0-11.9MP" type="Combo" required="true" />
         <spec name="Marka" value="Kodak" type="Combo" required="true" />
      </specs>
      <photos>
         <photo photoId="0">
            <url>http://images.gittigidiyor.com/2941/KODAK-Z915-10MP-10X-ZOOM-HD-SIFIR-URUN__29416457_0.jpg</url>
            <base64></base64>
         </photo>
         <photo photoId="1">
            <url>http://images.gittigidiyor.com/2941/KODAK-Z915-10MP-10X-ZOOM-HD-SIFIR-URUN__29416457_0.jpg</url>
            <base64></base64>
         </photo>
         <photo photoId="2">
            <url>http://images.gittigidiyor.com/2941/KODAK-Z915-10MP-10X-ZOOM-HD-SIFIR-URUN__29416457_0.jpg</url>
            <base64></base64>
         </photo>
         <photo photoId="3">
            <url>http://images.gittigidiyor.com/2941/KODAK-Z915-10MP-10X-ZOOM-HD-SIFIR-URUN__29416457_0.jpg</url>
            <base64></base64>
         </photo>
         <photo photoId="4">
            <url>http://images.gittigidiyor.com/2941/KODAK-Z915-10MP-10X-ZOOM-HD-SIFIR-URUN__29416457_0.jpg</url>
            <base64></base64>
         </photo>
      </photos>
      <pageTemplate>1</pageTemplate>
      <description>Kodak Z915 Fotograf Makinesi 10Mp 50X zoom</description>
      <startDate></startDate>
      <catalogId></catalogId>
      <catalogDetail></catalogDetail>
      <catalogFilter></catalogFilter>
      <format>S</format>
      <startPrice></startPrice>
      <buyNowPrice>240</buyNowPrice>
      <netEarning></netEarning>
      <listingDays>30</listingDays>
      <productCount>1</productCount>
      <cargoDetail>
         <city>34</city>
         <cargoCompanies>
            <cargoCompany>aras</cargoCompany>
         </cargoCompanies>
         <shippingPayment>B</shippingPayment>
         <cargoDescription></cargoDescription>
         <shippingWhere>country</shippingWhere>
      </cargoDetail>
      <affiliateOption>false</affiliateOption>
      <boldOption>false</boldOption>
      <catalogOption>false</catalogOption>
      <vitrineOption>false</vitrineOption>
   </product>
   <forceToSpecEntry>false</forceToSpecEntry>
   <nextDateOption>false</nextDateOption>
   <lang>tr</lang>
</prod:insertProduct>


Sonuç Parametreleri:

productId: Integer
    Ürün tekil anahtarı
result: String
    Mesaj metni


Örnek Sonuç:

<prod:insertProductResponse xmlns:prod="https://product.individual.ws.listingapi.gg.com">
   <return>
      <ackCode>success</ackCode>
      <responseTime>04/11/2010 14:50:09</responseTime>
      <timeElapsed>290 ms</timeElapsed>
      <productId>32351190</productId>
      <result>Ürün girişiniz başarıyla gerçekleştirilmiştir. Listeleme servisinden kontrol edebilirsiniz.</result>
   </return>
</prod:insertProductResponse>