Partner API v1

Postman Collection

BaZaaRDan Partner API v1 entegrasyonunu hızlı test etmek için hazırlanmış Postman starter kit. Collection içinde HMAC imza pre-request script ile otomatik üretilir.

Download

BaZaaRDan Postman Starter Kit

Paketin içinde Postman Collection ve Environment dosyaları bulunur. Partner sadece kendi Client ID, Client Secret ve client secret değerlerini girerek testlere başlayabilir.

POSTMAN PAKETİNİ İNDİR COLLECTION JSON ENVIRONMENT JSON

Paket İçeriği

Collection Orders, Order Detail, Stock Update ve Webhook örnek requestleri.

Environment base_url, client_id, client_secret, client_secret ve test değişkenleri.

HMAC Script Pre-request script ile X-BZ imza headerları otomatik üretilir.

Quick Test Partner bilgileri girildikten sonra tek tıkla endpoint test edilir.

Postman’a Import Etme

Import Steps

1. Postman uygulamasını açın.
2. Import butonuna tıklayın.
3. bazaardan-partner-api-v1.postman_collection.json dosyasını import edin.
4. bazaardan-partner-api-v1.postman_environment.json dosyasını import edin.
5. Sağ üstten BaZaaRDan Partner API v1 Environment seçin.
6. client_id, client_secret ve client_secret değerlerini doldurun.
7. List Orders requestini çalıştırarak bağlantıyı test edin.

Environment Değişkenleri

Environment Variables

base_url      = https://bazaardan.com/api/partner/v1
client_id     = YOUR_CLIENT_ID
client_secret = YOUR_CLIENT_SECRET
limit         = 20
offset        = 0
order_item_id = 12345
sku           = SKU-123

Otomatik HMAC Headerları

Collection içindeki pre-request script her istek öncesinde aşağıdaki headerları otomatik üretir.

Generated Headers

X-BZ-CLIENT-ID
X-BZ-TIMESTAMP
X-BZ-SIGNATURE
Accept: application/json
Content-Type: application/json

Requestler

GET/orders.php

Siparişleri listeler. Permission: orders:read

GET/order_detail.php

Tek sipariş detayını döndürür. Permission: orders:detail

POST/stock_update.php

SKU bazlı stok günceller. Permission: stock:write

Güvenlik Notu

Client Secret değeri frontend, mobil uygulama veya public repository içine konulmamalıdır. Postman environment dosyası paylaşılırken gerçek secret değerleri temizlenmelidir.