Hızlı başlangıç
-
Panelde Web Servis (API) paketini satın alın ve erişimi açın.
-
Aynı bölümden yeni API anahtarı oluşturun; tam metni yalnızca bir kez görürsünüz.
-
İstek adresini taban URL + uç yol ile kurun (ör.
/v1/me). Her istekte HTTP başlığına şunu ekleyin:Authorization: Bearerve hemen ardından boşluk ile panelde oluşturduğunuz anahtarın tamamı (ör.pc_live_…). Yani sunucunuza “Bearer” kelimesi değil,Bearer pc_live_sizin_anahtarinizgitmeli.
Taban URL
canlıİstek önekleri (otomatik algılanan host):
Örnek tam adres: /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
GETSorgu parametreleri
Hız sınırları (kurallar)
rate limitAynı API anahtarı (hesap) için limitler takvim saniyesi bazındadır. Aşımda HTTP 429 döner; yanıtta Retry-After: 1 başlığı gönderilir. Kısa aralıkla tekrar deneyin veya istekleri içinizde dağıtın.
Örnek: Üründe saniyede 1000 kayıt hakkınız varsa, limit=100 ile aynı saniyede en fazla 10 tam yanıt kullanabilirsiniz. Siparişte saniyede en fazla 10 istek.
Kod örnekleri
cURL
curl -sS https://www.api.pazarcan.com/v1/me \
-H "Authorization: Bearer pc_live_BURAYA_ANAHTARINIZ" \
-H "Accept: application/json"PHP (c ile curl)
$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]);
$res = curl_exec($ch);\n$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n$data = json_decode($res ?: '[]', true);Python (stdlib)
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'))