ApiKolay Entegrasyon Dokümanı

Tüm pazaryeri operasyonlarınızı tek bir XML endpoint üzerinden yönetin.

ApiKolay; Trendyol, N11, PttAVM, Hepsiburada ve Çiçeksepeti gibi pazaryerlerindeki siparişlerinizi ve ürünlerinizi standart bir formatta çekmenizi sağlayan bir ara katman API hizmetidir. Yanıtlar standart XML formatında döner.

Base URL: http://localhost:61116/api/v1

🔐 Kimlik Doğrulama

API güvenliği için pazaryeri anahtarlarını Query String parametresi olarak göndermelisiniz.

📦 XML Yanıt Modeli (Sipariş)

Sipariş çekme işlemlerinde API aşağıdaki formatta veri döndürür.


<SiparisBilgileri>
    <Platform>Trendyol</Platform>
    <SiparisTarihi>14.12.2025 10:30:00</SiparisTarihi>
    <SiparisDurumu>Tamamlandı</SiparisDurumu>
    <SiparisId>1020304050</SiparisId>
    <SiparisNo>9008007001</SiparisNo>
    <UrunAdi>Kablosuz Bluetooth Kulaklık - Siyah (Temsili Ürün)</UrunAdi>
    <Adet>2</Adet>
    <BirimFiyati>399.90</BirimFiyati>
    <ToplamFiyat>799.80</ToplamFiyat>
    <KdvOrani>20</KdvOrani>
    <ParaBirimi>TRY</ParaBirimi>
    <UrunId>11223344</UrunId>
    <UrunKodu>KUL-101</UrunKodu>
    <Barkod>8690000111222</Barkod>
    <KargoFirmasi>Yurtiçi Kargo</KargoFirmasi>
    <AdSoyadBireysel>Ahmet Yılmaz</AdSoyadBireysel>
    <AdresBireysel>Barbaros Bulvarı, Lale Sokak No:15 D:4</AdresBireysel>
    <SehirBireysel>İstanbul</SehirBireysel>
    <ilceBireysel>Beşiktaş</ilceBireysel>
    <TelefonBireysel>05551112233</TelefonBireysel>
    <MailBireysel>musteri@ornekmail.com</MailBireysel>
    <AdSoyadKurumsal>Ahmet Yılmaz</AdSoyadKurumsal>
    <AdresKurumsal>Barbaros Bulvarı, Lale Sokak No:15 D:4</AdresKurumsal>
    <SehirKurumsal>İstanbul</SehirKurumsal>
    <ilceKurumsal>Beşiktaş</ilceKurumsal>
    <VergiDairesi>Beşiktaş Vergi Dairesi</VergiDairesi>
    <VergiNo>1234567890</VergiNo>
    <TcNo>11111111111</TcNo>
    <Firma>Yılmaz Bilişim Hizmetleri Ltd. Şti.</Firma>
</SiparisBilgileri>

📦 XML Yanıt Modeli (Ürün)

Ürün çekme işlemlerinde API aşağıdaki formatta veri döndürür.


<UrunBilgileri>
    <UrunAdi>Renault Clio 4 R Yan Marşpiyel (ÇİFT)</UrunAdi>
    <Stok>2150</Stok>
    <UrunKodu>BKSTUNİNGSHOP339</UrunKodu>
    <StokKodu i:nil="true"/>
    <Barkod>TYBTL8B7NWYRHW0233</Barkod>
    <ListeFiyati>599.00</ListeFiyati>
    <SatisFiyati>450.00</SatisFiyati>
    <UrunDurumu>Satışa Kapalı</UrunDurumu>
    <SatisDurumu>1</SatisDurumu>
    <ParaBirimi>TRY</ParaBirimi>
</UrunBilgileri>
ℹ️ Bilgi: i:nil="true" ifadesi ilgili alanın boş (null) olduğunu belirtir.

Sipariş İşlemleri

GET

Trendyol Siparişlerini Getir

/orders/trendyol

Parametreler
Parametre Tip Durum Açıklama
supplierId String Zorunlu Trendyol Mağaza ID
apiKey String Zorunlu Trendyol API Key
apiSecret String Zorunlu Trendyol API Secret
status String Opsiyonel Sipariş Durumu (Örn: Created)
lastDays Integer Opsiyonel Son kaç gün (Örn: 7)
Örnek İstek
curl --request GET 'http://localhost:61116/api/v1/orders/trendyol?supplierId=100200&apiKey=TyOrnekKey123&apiSecret=TyOrnekSecret456&status=Created&lastDays=7'
GET

N11 Siparişlerini Getir

/orders/n11

Parametreler
Parametre Tip Durum Açıklama
apiKey String Zorunlu N11 API Key
apiSecret String Zorunlu N11 API Secret
status String Opsiyonel Sipariş Durumu (Örn: Shipped)
Örnek İstek
curl --request GET 'http://localhost:61116/api/v1/orders/n11?apiKey=N11OrnekApiKeyUuid&apiSecret=N11OrnekSecretKey123&status=Shipped'
GET

PttAVM Siparişlerini Getir

/orders/pttavm

Parametreler
Parametre Tip Durum Açıklama
ApiSupplierId String Zorunlu PttAVM Mağaza Adı / ID'si
ApiKey String Zorunlu PttAVM API Şifresi
Örnek İstek
curl --request GET 'http://localhost:61116/api/v1/orders/pttavm?ApiSupplierId=OrnekMagazaAdi&ApiKey=PttAvmSifre123'
GET

Hepsiburada Siparişlerini Getir

/orders/hepsiburada

Parametreler
Parametre Tip Durum Açıklama
merchantId String (GUID) Zorunlu Hepsiburada Satıcı ID (Merchant ID)
serviceKey String Zorunlu Entegrasyon Anahtarı (Service Key)
lastHours Integer Opsiyonel Son kaç saatin siparişleri çekilecek? (Örn: 24)
Örnek İstek
curl --request GET 'http://localhost:61116/api/v1/orders/hepsiburada?merchantId=00000000-0000-0000-0000-000000000000&serviceKey=HbServiceKeyOrnek123&lastHours=24'
GET

Çiçeksepeti Siparişlerini Getir

/orders/ciceksepeti

Parametreler
Parametre Tip Durum Açıklama
ApiSupplierId String Zorunlu Çiçeksepeti Bayi/Tedarikçi ID
ApiKey String Zorunlu Çiçeksepeti API Anahtarı
Örnek İstek
curl --request GET 'http://localhost:61116/api/v1/orders/ciceksepeti?ApiSupplierId=OrnekBayiId&ApiKey=CsApiKeyOrnek987654321'

Ürün İşlemleri

GET

Trendyol Ürünlerini Getir

/products/trendyol

Parametreler
Parametre Tip Durum Açıklama
supplierId String Zorunlu Trendyol Mağaza ID
apiKey String Zorunlu Trendyol API Key
apiSecret String Zorunlu Trendyol API Secret
status String Opsiyonel Ürün Durumu (Örn: Created)
Örnek İstek
curl --request GET 'http://localhost:61116/api/v1/products/trendyol?supplierId=100200&apiKey=TyOrnekKey123&apiSecret=TyOrnekSecret456&status=Created'
GET

N11 Ürünlerini Getir

/products/n11

Parametreler
Parametre Tip Durum Açıklama
apiKey String Zorunlu N11 API Key
apiSecret String Zorunlu N11 API Secret
page Integer Opsiyonel Sayfa Numarası (Varsayılan: 1)
pageSize Integer Opsiyonel Sayfa Başına Ürün Sayısı (Örn: 50)
Örnek İstek
curl --request GET 'http://localhost:61116/api/v1/products/n11?apiKey=N11OrnekApiKeyUuid&apiSecret=N11OrnekSecretKey123&page=1&pageSize=50'