İçeriğe atla
API
Panelden anahtar
Geliştirici / Web Servis

Web API dokümantasyonu

Sipariş, ürün ve kategori verilerinize güvenli JSON API ile erişin. Anahtar ve erişim için panelde Hesap → Web Servis (API) bölümünü kullanın.

Canlı · v1

Hızlı başlangıç

Üç adımda ilk isteğinizi atın

  1. Panelde Web Servis (API) erişimini açın.

  2. Aynı bölümden yeni API anahtarı oluşturun; tam metni yalnızca bir kez görürsünüz.

  3. İstekleri https://www.api.pazarcan.com/v1 altına yöneltin. Her çağrıda Authorization: Bearer pc_live_… başlığını ekleyin.

JSON Bearer Yalnızca GET CORS açık

Taban URL

Canlı ortam öneki
canlı
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ı
GET
YolAçı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; panel ile aynı kapsam.
/v1/categories Kategori listesi / ağaç.

Sorgu parametreleri

Liste uçları için
ParametreUçlarVarsayılanNot
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
rate limit

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.

KuralUç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'))

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.