Pazaryerinde kod yazma zamanı

🚀 Quickstart — 60 saniyede ilk istek

API anahtarınızı admin panelinden alın, JWT üretin, ilk endpoint'i çağırın.

# 1. JWT üret (1 saat geçerli)
curl -sS -X POST https://api.herseypazar.com/v2/auth/token \
  -H 'Content-Type: application/json' \
  -d '{"api_key":"hsp_pk_live_xxx","api_secret":"hsp_sk_live_xxx"}' \
  | jq -r .access_token

# 2. İlk istek: aktif satıcıları listele
TOKEN=$(...)  # yukarıdaki çıktı
curl -sS https://api.herseypazar.com/v2/sellers?limit=5 \
  -H "Authorization: Bearer $TOKEN"

import { Her Şey Pazar } from '@herseypazar/sdk';

const hsp = new Her Şey Pazar({
  apiKey: 'hsp_pk_live_xxx',
  apiSecret: 'hsp_sk_live_xxx',
  // baseUrl varsayılanı: https://api.herseypazar.com/v2
});

// İlk istek
const sellers = await hsp.sellers.list({ tier: 'gold', limit: 10 });
console.log(sellers.items.length, 'satıcı bulundu');

// İlan yayınla
const listing = await hsp.listings.create({
  title: 'Samsung Galaxy S24 Ultra',
  price: 54999.90,
  currency: 'TRY',
  stock: 5,
  category_id: '...',
  condition: 'new',
});

from herseypazar import Her Şey PazarClient

hsp = Her Şey PazarClient(api_key="hsp_pk_live_xxx", api_secret="hsp_sk_live_xxx")

# İlk istek
sellers = hsp.sellers.list(tier="gold", limit=10)
print(f"{len(sellers.items)} satıcı bulundu")

# Webhook abone ol
hook = hsp.webhooks.create(
  url="https://magaza.example.com/webhooks/hsp",
  events=["order.placed", "order.shipped", "payment.refunded"],
)
print("Signing secret (sadece bir kez gösterilir):", hook.signing_secret)

📦 21 endpoint, 9 kategori

Public API ile yapabileceklerin (kart tıkla → Swagger UI'da o kategoriyi aç):

📚 Resmi SDK'lar

İki ana dilde resmi SDK — TypeScript tipli, retry + idempotency + webhook signature verify dahil.

🛰️ Webhook imzası doğrulama

Her webhook payload'ı X-HSP-Signature header'ında HMAC SHA-256 imzasıyla gelir. signing_secret'iniz ile doğrulayın:

// Node.js
import { verifyWebhook } from '@herseypazar/sdk/webhooks';

app.post('/webhooks/hsp', (req, res) => {
  const sig = req.headers['x-hsp-signature'];
  const ok = verifyWebhook(req.rawBody, sig, process.env.HSP_WEBHOOK_SECRET);
  if (!ok) return res.sendStatus(401);
  // İmza geçerli — event'i işle
  const event = JSON.parse(req.rawBody);
  console.log('Event:', event.type, event.data);
  res.sendStatus(200);
});

⚡ Rate Limit & Tier'lar

İstek başına Redis token-bucket. Tier × endpoint granular. Her response X-RateLimit-Remaining header'ı taşır.