Kimlik doğrulama
Pazarama OAuth2 client credentials akışını kullanır. API Key ve API Secret İş Ortağım panelinde Hesabım, Hesap Bilgileri, Entegrasyon Bilgileri sekmesindedir. Bu ikiliyle POST https://isortagimgiris.pazarama.com/connect/token adresinden token alınır: Basic başlık, grant_type=client_credentials ve scope=merchantgatewayapi.fullaccess.
Token her API isteğinde Authorization: Bearer başlığıyla gönderilir ve canlı kayıtlara göre yaklaşık bir ay geçerlidir. API Secret ise bir yıl geçerlidir. Ayrıntılar: API Key ve Secret alma, token alma.
Adresler
| Görev | Adres |
|---|---|
| Kimlik (token) | https://isortagimgiris.pazarama.com/connect/token |
| API | https://isortagimapi.pazarama.com |
| Panel ve doküman | https://isortagim.pazarama.com |
Ürün, kategori, marka, stok ve fiyat servisleri /product, siparişler /order ile başlar. Ayrı bir test ortamı bu rehberde doğrulanamadı. Ayrıntı: servis adresleri ve yanıt yapısı.
İstek sınırları
Canlıda çalışan entegrasyon toplu stok ve fiyat isteklerini satıcı başına yaklaşık 10 saniyede bir ve istek başına en fazla 3.000 kalemle gönderir. Bu servisler eşzamansızdır: 200 yanıtı isteğin sıraya alındığını gösterir. Sınır aşılırsa 429, servis meşgulse 503 döner. Ayrıntı: istek sınırı ve hata yönetimi.
Bu rehber neyi doğruladı?
| İşlem | Uç nokta | Durum |
|---|---|---|
| Token alma | POST /connect/token | Doğrulandı (OpenID belgesi ve canlı kod) |
| Ürün listesi | POST /product/getProducts | Canlıda doğrulandı |
| Kategori ağacı | GET /product/getCategoryTree | Canlıda doğrulandı |
| Marka listesi | POST /product/getBrands | Canlıda doğrulandı |
| Stok güncelleme | POST /product/updateStock-v2 | Canlıda doğrulandı |
| Fiyat güncelleme | POST /product/updatePrice-v2 | Canlıda doğrulandı |
| Sipariş listesi | POST /order/getOrdersForApi | Canlıda doğrulandı |
| Ürün açma, kargo, iade, fatura, soru | - | Doğrulanamadı |
Pazarama'nın entegrasyon dokümanı panelde tarayıcıda çalışan bir uygulama içinde yayımlanır ve otomatik okunamadı. Doğrulanamayan işlemler için uç nokta ya da alan adı yazmadık; bunları dokümandan kontrol edin.
Genel hata kodları
| Durum | Anlamı |
|---|---|
| 200 ve success=false | İstek ulaştı ama işlem reddedildi; message alanına bakın |
| 400 ya da 401 (token isteği) | API Key ya da Secret hatalı veya süresi dolmuş |
| 401 (API isteği) | Token süresi dolmuş; bir kez yenileyip tekrarlayın |
| 404 | Yol yanlış; stok ve fiyatta v2 yoksa eski yol denenir |
| 429 | İstek sınırı aşıldı; Retry-After kadar bekleyin |
| 503 | Servis geçici olarak hizmet dışı |
Pazarama API işlemleri
Genel
Ürün ve katalog
Stok ve fiyat
Sipariş
Sık sorulanlar
Pazarama API dokümanı nerede?
İş Ortağım panelinin üst menüsündeki Entegrasyon bağlantısında; adres isortagim.pazarama.com/auth/integration ile başlar ve tarayıcıda açılır.
Pazarama API'ye nasıl bağlanılır?
Panelden API Key ve API Secret alınır, bu ikiliyle connect/token adresinden OAuth2 token istenir ve istekler https://isortagimapi.pazarama.com adresine Bearer token ile gönderilir.
Pazarama API ile hangi işlemler yapılabilir?
Bu rehberde doğrulananlar: ürün listesi, kategori ağacı, marka listesi, stok ve fiyat güncelleme, sipariş listesi. Ürün açma, kargo, iade ve fatura servisleri doğrulanamadı.
Pazarama API Secret süresi dolarsa ne olur?
Token alınamaz ve tüm servisler durur. Panelden yeni Secret alıp bağlı yazılımlardaki değeri güncellemeniz gerekir.
Pazarama entegrasyonu için hazır bir yazılım kullanabilir miyim?
Evet. Kendi yazılımınızı geliştirmek yerine bir entegrasyon yazılımına API Key ve API Secret girerek bağlanabilirsiniz; Pazarama entegrasyonu sayfası bu yolu anlatır.