API C# CLIENT Kullanıcı Kılavuzu - dev.gittigidiyor.com · C# CLIENT Kullanıcı API Kılavuzu...
Transcript of API C# CLIENT Kullanıcı Kılavuzu - dev.gittigidiyor.com · C# CLIENT Kullanıcı API Kılavuzu...
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)