Partner API v1

Sandbox & Test Ortamı

BaZaaRDan Partner API için bağımsız sandbox ortamı ayrıca duyurulacaktır. Şu anda entegratör testleri, BaZaaRDan tarafından verilen onaylı test client bilgileriyle production base URL üzerinde kontrollü şekilde yapılır.

TEST FLOW Postman / SDK / Test Webhook
Production Base URL https://bazaardan.com/api/partner/v1
Sandbox Ayrı ortam daha sonra duyurulacak
Recommended Postman Starter Kit

Test İçin Önerilen Akış

Adım Açıklama
1. Client bilgileri BaZaaRDan ekibi entegratöre Client ID ve Client Secret verir.
2. Postman ile doğrulama Postman Starter Kit içindeki environment değerleri doldurulur.
3. Ping testi GET /ping.php endpointi ile authentication test edilir.
4. Sipariş testi GET /orders.php ve GET /order_detail.php ile veri okuma test edilir.
5. Stok testi Kontrollü test ürünü üzerinde POST /stock_update.php denenir.
6. Webhook testi Entegratör HTTPS webhook URL’si verir; BaZaaRDan admin panelinden test event gönderilir.

Base URL

Production Test Base URL
https://bazaardan.com/api/partner/v1

Örnek Test Sırası

Endpoint Test Order
1. GET  /ping.php
2. GET  /orders.php?limit=10&offset=0
3. GET  /order_detail.php?order_item_id={order_item_id}
4. POST /stock_update.php
5. Webhook test event

Authentication

Test isteklerinde de canlı sistemle aynı HMAC standardı kullanılır. İmza formatı aşağıdaki gibidir:

HMAC Base String
METHOD + "
" + PATH + "
" + TIMESTAMP + "
" + RAW_BODY
Client Secret frontend, mobil uygulama, public repository veya tarayıcı içinde saklanmamalıdır. Testler entegratörün backend ortamında veya Postman gibi kontrollü araçlarla yapılmalıdır.

Postman ile Test

Hazır request ve HMAC imza scriptleri için Postman Starter Kit kullanın.

POSTMAN STARTER KIT İNDİR POSTMAN REHBERİ

SDK ile Test

Entegratör kendi backend teknolojisine göre PHP veya Node.js starter kit kullanabilir.

PHP SDK Node.js SDK

Webhook Testi

Webhook testi için entegratör HTTPS endpoint URL’si paylaşır. BaZaaRDan admin ekibi test event gönderir. Entegratör gelen istekte X-BZ-WEBHOOK-SIGNATURE headerını doğrulamalıdır.

Webhook Headers
X-BZ-WEBHOOK-ID
X-BZ-WEBHOOK-TIMESTAMP
X-BZ-WEBHOOK-SIGNATURE
X-BZ-WEBHOOK-EVENT

Related Pages

İlk kurulum için Quick Start, imza detayları için Authentication, endpoint detayları için Orders, Order Detail, Stock Update ve Webhooks sayfalarını kullanın.