Hızlı başlangıç
Üç adımda ilk isteğinizi atın
Panelde Web Servis (API) erişimini açın.
Aynı bölümden yeni API anahtarı oluşturun; tam metni yalnızca bir kez görürsünüz.
İstekleri
https://www.api.pazarcan.com/v1altına yöneltin. Her çağrıdaAuthorization: Bearer pc_live_…başlığını ekleyin.
JSON
Bearer
Yalnızca GET
CORS açık
Taban URL
Canlı ortam öneki
Base
https://www.api.pazarcan.com/v1
Örnek: /v1/me, /v1/orders?page=1&limit=20
Kimlik doğrulama
Her çağrıda zorunlu başlık
Üç nokta yerine kendi anahtarınızı yapıştırın; Bearer ile anahtar arasında tek boşluk olmalı.
Authorization: Bearer pc_live_…Anahtarı paylaşmayın; sunucu tarafında ortam değişkeni veya gizli yapılandırma dosyasında tutun.
Uç noktalar
Temel okuma uçları
| Yol | Açıklama |
|---|---|
/v1/me |
Oturum özeti: users_id, API bitiş zamanı (api_until). |
/v1/orders |
Sipariş listesi (sayfalı). Yalnızca mağazanıza ait kayıtlar. |
/v1/orders/{id} |
Tek sipariş gövdesi + satır detayları. |
/v1/products |
Ürün listesi (ad, barkod, fiyat, stok, kısa/uzun açıklama, görseller, kategori, marka). description ve images alanlarını kullanın. |
/v1/categories |
Kategori listesi / ağaç. |
Sorgu parametreleri
Liste uçları için
| Parametre | Uçlar | Varsayılan | Not |
|---|---|---|---|
page |
/orders, /products |
1 |
Sayfa numarası (≥ 1). |
limit |
/orders, /products |
50 |
Sayfa başına kayıt; en fazla 100. |
Hız sınırları
Takvim saniyesi bazında
Aşımda HTTP 429 döner; yanıtta Retry-After: 1 başlığı gönderilir. Kısa aralıkla tekrar deneyin veya istekleri dağıtın.
| Kural | Uçlar | Üst sınır | Ölçüm |
|---|---|---|---|
| Sipariş sorguları | /v1/orders, /v1/orders/{id} |
10 istek / sn | Her başarılı istek 1 sayaç harcar. |
| Ürün okuma | /v1/products |
1000 kayıt / sn | Yanıttaki ürün kaydı adedi kadar artar (sayfa ≤ 100). |
| Diğer | /v1/me, /v1/categories |
— | Ayrı kota yok; makul kullanın. |
Örnek: Üründe saniyede 1000 kayıt hakkınız varsa,
limit=100 ile aynı saniyede en fazla 10 tam yanıt kullanabilirsiniz.Kod örnekleri
cURL, PHP ve Python
cURL
curl -sS https://www.api.pazarcan.com/v1/me \
-H "Authorization: Bearer pc_live_BURAYA_ANAHTARINIZ" \
-H "Accept: application/json"PHP
$base = 'https://www.api.pazarcan.com/v1';
$token = 'pc_live_BURAYA_ANAHTARINIZ';\n\n$ch = curl_init($base . '/orders?limit=10');\ncurl_setopt_array($ch, [\n CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . , 'Accept: application/json'],
CURLOPT_RETURNTRANSFER => true,\n CURLOPT_TIMEOUT => 30,\n]);\n$res = curl_exec($ch);\n$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n$data = json_decode($res ?: '[]', true);Python
import urllib.request\n\nBASE = "https:\/\/www.api.pazarcan.com\/v1"\nTOKEN = 'pc_live_BURAYA_ANAHTARINIZ'\n\nreq = urllib.request.Request(\n BASE + '/orders?limit=10',\n headers={'Authorization': 'Bearer ' + TOKEN, 'Accept': 'application/json'}\n)\nwith urllib.request.urlopen(req, timeout=30) as resp:\n print(resp.status, resp.read().decode('utf-8'))Ürün yanıtı alanları
/v1/products kayıt gövdesiListe uçlarında her ürün kaydı aşağıdaki alanları içerir. Görsel ve açıklama için images ile description kullanın.
| Alan | Açıklama |
|---|---|
product_name | Ürün adı |
barcode, sku | Barkod ve stok kodu |
price, old_price, stock | Fiyat, eski fiyat ve stok |
description | Ürün açıklaması (kaynakta yoksa boş metin) |
images | Görsel URL listesi (dizi); ilk eleman ana görsel |
category_name, category_id | Kategori bilgisi |
xml_id, seo_url | Kaynak XML ve SEO adresi |
HTTP yanıt kodları
Sık görülen durumlar
401Bearer eksik, geçersiz veya Web API süresi dolmuş.
404Tanımsız yol veya sipariş bulunamadı.
405Yalnızca GET desteklenir.
429Hız sınırı aşıldı. Kurallar
503Ürün uçları geçici olarak kullanılamıyor.