Partner API v1

Node.js / TypeScript SDK Starter Kit

BaZaaRDan Partner API v1 entegrasyonuna Node.js veya TypeScript projelerinde hızlı başlamak için hazırlanmış starter kit. HMAC imza üretimi, sipariş listeleme, sipariş detayı, stok güncelleme ve webhook doğrulama örneklerini içerir.

Download

BaZaaRDan Node.js SDK Starter Kit

Paketin içinde TypeScript client, örnek komutlar, webhook receiver örneği ve README dokümanı bulunur.

NODE.JS SDK PAKETİNİ İNDİR

Paket İçeriği

BazaardanClient.ts Client ID + HMAC SHA256 imzalı API istekleri için ana TypeScript client.

BazaardanWebhook.ts Gelen webhook istekleri için timestamp.body imza doğrulama helper dosyası.

Examples Ping, sipariş listeleme, sipariş detayı, stok güncelleme ve webhook receiver örnekleri.

TypeScript tsconfig, type declarations ve build scriptleri hazırdır.

Kurulum

Install

npm install
cp .env.example .env

Ortam Değişkenleri

Environment

BAZAARDAN_API_BASE=https://bazaardan.com/api/partner/v1
BAZAARDAN_CLIENT_ID=YOUR_CLIENT_ID
BAZAARDAN_CLIENT_SECRET=YOUR_CLIENT_SECRET
BAZAARDAN_WEBHOOK_SECRET=YOUR_WEBHOOK_SECRET

Gerçek Auth Standardı

Partner API v1 istekleri Client ID + HMAC SHA256 imzası ile doğrulanır. Node SDK her request öncesinde aşağıdaki headerları otomatik üretir.

Auth Headers

X-BZ-CLIENT-ID
X-BZ-TIMESTAMP
X-BZ-SIGNATURE

Signature Base String

METHOD + "\n" + PATH + "\n" + TIMESTAMP + "\n" + RAW_BODY

Komutlar

Commands

npm run ping
npm run list-orders
npm run order-detail -- 12345
npm run update-stock -- SKU-123 25
npm run webhook-receiver

Endpointler

GET/ping.php

Partner API bağlantı ve HMAC imza kontrolü.

GET/orders.php

Siparişleri listeler. Permission: orders:read

GET/order_detail.php

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

POST/stock_update.php

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

Webhook Doğrulama

Webhook Headers

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

Webhook Signature

hash_hmac("sha256", timestamp + "." + raw_body, webhook_secret)

Güvenlik Notu

Client Secret frontend, mobil uygulama veya public repository içine konulmamalıdır. HMAC imzası her zaman backend tarafında üretilmelidir.