Partner API v1

BaZaaRDan Developer Platform

ERP, muhasebe, depo, kargo, stok yönetimi, AI agent ve özel partner uygulamalarını BaZaaRDan satıcı verilerine güvenli şekilde bağlamak için geliştirilen Partner API ekosistemi.

Start Here

5 Dakikada İlk Entegrasyon Testi

En hızlı başlangıç için Quick Start rehberini açın, Postman paketini indirin, Client ID / Client Secret bilgilerinizi girin ve önce /ping.php endpointini test edin.

QUICK START POSTMAN PAKETİNİ İNDİR

Satıcılar API Bilgilerini Nereden Alır?

Satıcı, panel içindeki Hesabım / Ayarlar > Entegrasyon Bilgileri sekmesinden Open Partner API erişimi talep eder. Admin onayı sonrası Client ID, Client Secret ve Base URL aynı ekranda görünür.

API KULLANIMINA BAŞLA AUTHENTICATION

Starter Kitler

Postman Starter Kit HMAC imzasını otomatik üreten collection ve environment dosyaları.

Postman Rehberi
PHP SDK Starter Kit PHP backend entegrasyonları için hazır client ve webhook doğrulama helperı.

PHP SDK Rehberi
Node.js / TypeScript SDK Node.js, Express, NestJS ve TypeScript backend projeleri için starter kit.

Node.js SDK Rehberi
Partner Onboarding Partner app oluşturma, permission seçimi ve production geçiş akışı.

Onboarding Rehberi

Auth Standardı

Partner API v1 istekleri Client ID + HMAC SHA256 imzası ile doğrulanır. Client Secret yalnızca backend ortam değişkenlerinde tutulmalıdır.

Required Headers
X-BZ-CLIENT-ID
X-BZ-TIMESTAMP
X-BZ-SIGNATURE
Signature Base String
METHOD + "\n" + PATH + "\n" + TIMESTAMP + "\n" + RAW_BODY

Temel Endpointler

GET/ping.php

Client bilgileri ve HMAC imza doğruluğunu test eder.

GET/orders.php

Sipariş kalemlerini listeler. Permission: orders:read

GET/order_detail.php

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

POST/stock_update.php

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

DOC/reference/xml-feed.php

XML URL veya XML dosyası ile ürün, stok, fiyat, varyant ve görsel aktarım formatını açıklar.

Webhook Sistemi

BaZaaRDan olayları partner webhook endpointine imzalı şekilde gönderir. Partner tarafında gelen her webhook için signature doğrulaması yapılmalıdır.

Webhook Headers
X-BZ-WEBHOOK-ID
X-BZ-WEBHOOK-TIMESTAMP
X-BZ-WEBHOOK-SIGNATURE
X-BZ-WEBHOOK-EVENT
Queue Webhook eventleri önce kuyruğa yazılır.
Delivery Aktif endpointlere imzalı HTTP POST gönderilir.
Retry Başarısız teslimatlar backoff mantığıyla tekrar denenir.
Security İmza formatı: timestamp + "." + raw_body

Production Checklist

  • Client ID ve Client Secret production ortam değişkenlerinden okunuyor.
  • Client Secret frontend, mobil uygulama veya public repository içinde yok.
  • Postman ile /ping.php testi başarılı.
  • /orders.php testi başarılı.
  • /stock_update.php kontrollü ürün üzerinde başarılı.
  • Webhook endpointi 2xx cevap döndürüyor.
  • Webhook signature doğrulaması aktif.
  • Permission listesi minimum yetki prensibine göre verildi.

İndirilebilir Paketler

Postman 1.0.8 Collection + Environment.

İndir
PHP SDK 1.0.8 PHP client + webhook verifier.

İndir
Node.js SDK 1.0.8 TypeScript client + examples.

İndir
Swagger / OpenAPI Endpoint şeması ve header standartları.

Swagger UI