API C# CLIENT Kullanıcı Kılavuzu GittiGidiyor Api CSharp client hakkında bilgi. VERSİYON 2.4.0 http://www.gittigidiyor.com/ http://dev.gittigidiyor.com/ GittiGidiyor Bilgi Teknolojileri San. Ve Tic. A.S. Hazırlayan : Hakan İlter,Fatih Demirez 6/17/2010

2

GİRİŞ

Bu doküman API için yazılan C# client kütüphanesinin kullanımını anlatmak ve örnek kod gösterimleri ile

kütüphane üzerinden yazılabilecek kod blokları hakkında fikir vermek amacıyla oluşturulmuştur. Client

kullanarak servis çağırımları için gerekli dosyalar http://dev.gittigidiyor.com/araclar-dokumanlar adresinden

indirebilirisiniz.

SERVİS KULLANIMI ve ÖRNEK KODLAR

“ApiV2Client.dll ” ve “ApiV2Client.XmlSerializers.dll” olmak üzere 2 adet kütüphane dosyası bulunmaktadır.

Yapacağınız uygulamaya “References” bölümüne sağ tıklayıp add reference işlemi yaparak bu iki

kütüphaneyi eklemelisiniz.

Servis erişimi için Basic Authtentication kontrolunu aşmak için 2 yöntme vardır. Birincisi

www.dev.gittigidiyor.com adresinde araçlar ve dökümanlar bölümünden temin edebileceğiniz auth-config.xml

dosyasını Addexisting itemauth-config.xml şeklinde ekleyerek uygulamanıza dahil edebilirsiniz.

3

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<auth-params>

<api-key></api-key>

<secret-key></secret-key>

<role-name></role-name>

<role-pass></role-pass>

</auth-params>

İkinci yöntem ise uygulama içinde bu parametreleri tanımlayabilirsiniz.

ApiKey ve SecretKey alanlarını http://dev.gittigidiyor.com/api-anahtarlari bölümünden oluşturabilirsiniz.

RoleName ve RolePass alanlarını http://dev.gittigidiyor.com/sikca-sorulan-sorular bize ulaşın bölümünden

mail atarak rol tanımı isteyerek tanımlatmalısınız.

Kütüphanede kullanılacak servisler ServiceProvider sınıfı üzerinden alınabilir. Kullanacağınız servisin sınıfını üst

bölümde tanıtmalısınız.

4

Geliştirici Oluşturmak (DeveloperService - createDeveloper

Uygulama Yaratmak (ApplicationService - createApplication)

5

Uygulama Listesini Almak (ApplicationService - getApplicationList)

6

Şehir Listesini Almak (CityService - getCities)

7

Kategori Bilgisi Almak (Category - getCategory)

8

Ürün Girişi Yapmak (ProductService - insertProduct)

Insert product methodunda dikkat edilmesi gereken konu; product objesinin speclerinden integer olanları set ettiğiniz

zaman , specified özelliğini de true olarak set etmek durumundasınız.

9

10

Ödeme Sepeti Fiyatını Hesaplatmak (ProductService - calculatePriceForShoppingCart)

Ürün Fiyatını Ödemek/Satışa Çıkarmak (ProductService - payPrice)

11

Fiyat Güncellemek (ProductService - updatePrice)

Stok Güncellemek (ProductService - updateStock)

12

Ürün Listesini Almak (ProductService - getProducts)

13

Satış Bilgisini Almak (SaleService - getSale)

14

Kargo Bilgisi Girmek (CargoService - sendCargoInformation)

Mesaj Göndermek (MessageService – sendNewMessage)

15

Gelen Kutusundaki Mesajları Almak (MessageService - getInboxMessages)

16

Dükkan Bilgilerini Almak (StoreService – getStore)

Satılmayanlar Ürünler (ActivityService– getunSoldItems)

17

İzlediklerim (ActivityService– getWatchItems)

18

Öntanımlı Adres Bilgilerini Almak (AddressService– getDefaultAddress)

19

Arama (Search Service– search)

20

Stok ve Fiyat bilgilerini Almak (ProductService– getStockAndPrice)