PazarOMatik API, kendi yazılımınızı (e-ticaret siteniz, ERP / muhasebe programınız, raporlama aracınız, Zapier / Make / n8n akışlarınız) PazarOMatik Express'e bağlamanızı sağlar. Ürün ve stoklar, pazaryeri siparişleri, müşteri soruları, iadeler, cariler, ticari belgeler, kasa / banka ve raporlar tek bir REST API'den okunur; değişiklikler webhook ile anında adresinize gelir.

📖 API referansı (etkileşimli) 📡 Webhook rehberi OpenAPI 3.1 dosyası

API ve webhook'lar Bulut aboneliğine dahildir; ek ücret yoktur.

Nasıl çalışır?

PazarOMatik Express bilgisayarınızda çalışan bir programdır; bulut açıksa verileriniz Türkiye'deki sunucumuzda firmanıza özel alana eşitlenir. API bu buluttan çalışır:

Okumalar anında gelir (buluttaki güncel kopya; program açıkken değişiklikler birkaç saniye / dakika içinde yansır).
Yazmalar istek olarak programa gider ve program açıkken kendi kurallarıyla işlenir: stok, cari hesap, belge numarası, pazaryerine gönderim masaüstündeki gibi olur. Yazma isteği hemen 202 Accepted ve bir request_id döner; sonucu GET /v2/requests/{id} ile ya da request.completed webhook'u ile alırsınız.
Web panel ve telefon uygulaması da aynı yolu kullanır; API ile yapılan her işlem programın İşlem Günlüğü'nde "API: anahtar adı" olarak görünür.

1. Anahtar oluşturun

Programda Ayarlar > Bulut > 🔑 API ve webhook'lar > Yeni anahtar. Anahtara bir ad verin ve yalnız gereken yetkileri seçin. Anahtar (pzm_<FİRMA KODU>_...) yalnız bir kez gösterilir; bir sonraki bulut eşitlemesinden sonra (en geç birkaç dakika) çalışır.

2. İlk isteğiniz

Adres: https://pazaromatik.com.tr/site/api/v2/ — anahtarı her istekte Authorization: Bearer başlığıyla gönderin.

curl https://pazaromatik.com.tr/site/api/v2/me \
  -H "Authorization: Bearer pzm_ABC123_0123456789abcdef0123456789abcdef"

# Ürünler (ilk 100; her üründe toplam stok)
curl "https://pazaromatik.com.tr/site/api/v2/products?limit=100" -H "Authorization: Bearer $PZM_KEY"

# Son 7 günün Trendyol siparişleri
curl "https://pazaromatik.com.tr/site/api/v2/orders?channel=trendyol&from=2026-10-08" -H "Authorization: Bearer $PZM_KEY"

3. Yetkiler

Her anahtara kaynak bazında okuma / yazma yetkisi verilir. Yetkisi olmayan çağrı 403 forbidden döner.

Kaynak	Okuma (`:read`)	Yazma (`:write`)
`products`	Ürünler, stok, depolar, kategoriler, pazaryeri ilanları	Ürün oluştur / güncelle / sil, stok girişi / çıkışı, ilan eşleştirme, fiyat / stok gönderimi, reçete / üretim
`orders`	Pazaryeri / e-ticaret siparişleri, müşteri soruları, iadeler	Sipariş işlemleri (stoktan düş, programa al, durum, personel, etiket), soru cevaplama, iade onayı, desi itirazı
`customers`	Cariler, bakiye, hesap hareketleri	Cari oluştur / güncelle, ziyaret / arama / not, CRM (aday, fırsat, fuar), talep / servis
`documents`	Teklif, sipariş, satış / alış faturası, irsaliye (kalemleriyle)	Belge oluştur, dönüştür, sevk, irsaliye, tahsilat
`finance`	Kasa / banka hesapları ve hareketleri	Tahsilat / ödeme, para hareketi, virman, gider, çek / senet, ödeme linki
`reports`	Satış raporu, finans özeti, mağaza sağlığı, nakit takvimi, hakediş	—

SMS / e-posta gönderme ve programın iç işlemleri API'ye kapalıdır.

4. Yanıt biçimi ve sayfalama

Tek kayıt {"data": {...}}; liste {"data": [...], "meta": {"pagination": {"limit": 100, "next_cursor": "..."}}} döner. Listeler imleçlidir: ilk istekte ?limit=N, sonra yanıttaki next_cursor değerini ?limit=N&cursor=... olarak aynen gönderin; next_cursor null ise liste bitmiştir. Sayfa başına en çok 500 kayıt.

curl "https://pazaromatik.com.tr/site/api/v2/products?limit=500&cursor=aTo1MDA" -H "Authorization: Bearer $PZM_KEY"

Tarihler Türkiye saatiyle (Europe/Istanbul) ISO biçimindedir. Tutarlar sayıdır; para birimi kaydın currency alanındadır (çoğunlukla TRY). Ürün sale_price KDV dahildir.

5. Yazma istekleri

# Ürünün stoğuna 25 adet giriş (ana depo: GET /v2/warehouses)
curl -X POST https://pazaromatik.com.tr/site/api/v2/products/12/stock-movements \
  -H "Authorization: Bearer $PZM_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: stok-giris-2026-10-15-0001" \
  -d '{"mode": "in", "qty": 25, "warehouse_id": 1, "note": "Tedarikçiden"}'

{"data": {"request_id": 4812, "status": "bekliyor", "status_url": "/api/v2/requests/4812"}}

Idempotency-Key başlığını gönderin: ağ hatasında aynı isteği tekrar gönderirseniz ikinci kez işlenmez (aynı request_id döner).
Sonuç: GET /v2/requests/4812 → status: bekliyor → islendi ya da hata; message programın açıklaması, ref oluşan kaydın numarası.
Program kapalıysa istek bekler; program açılınca sırayla işlenir.
Otomatik stok eşitleme açıksa API'den giren stok değişikliği programın kurallarıyla tüm pazaryerlerine gönderilir.

Genel kayıt uçları: Panelde yapılabilen her şey API'de de vardır. GET /v2/schema kayıt türlerini (ürün, cari, belge, gider, aktivite, aday, fırsat, üretim emri, çek / senet...), alanlarını, seçeneklerini ve işlemlerini verir. POST /v2/records/{tür}, PATCH /v2/records/{tür}/{id}, DELETE /v2/records/{tür}/{id} ve POST /v2/records/{tür}/{id}/actions/{işlem} ile kullanılır. Güncellemede orig (sizin bildiğiniz eski değerler) gönderirseniz, alan bu arada programda değiştiyse istek reddedilir; değişiklikler birbirini ezmez.

6. Sınırlar ve hatalar

Anahtar başına dakikada 120 istek. Aşılırsa 429 ve Retry-After (saniye) döner; o kadar bekleyip tekrar deneyin. Her yanıtta X-RateLimit-Remaining ve destek için X-Request-Id başlığı vardır.

Durum	Anlamı
`401 unauthorized`	Anahtar yok, hatalı ya da iptal edilmiş
`403 forbidden` / `cloud_inactive`	Anahtarın bu yetkisi yok / bulut aboneliği etkin değil
`404 not_found`	Kayıt ya da uç yok
`405 op_not_allowed`	Bu kayıt türünde bu işlem yapılamaz
`422 invalid`	Gövde doğrulanamadı (ayrıntı `error.message`'da)
`429 rate_limited`	Dakikalık sınır aşıldı

Hata gövdesi: {"error": {"code": "...", "message": "...", "request_id": "..."}}.

7. Webhook'lar

Sorup durmak yerine olayları adresinize alın: yeni sipariş, sipariş durumu / kargo, stok değişimi, ilan fiyat / stok, yeni soru, yeni iade, yeni belge / cari, istek sonucu. Her gönderim HMAC-SHA256 ile imzalıdır. Kurulum, olay listesi ve imza doğrulama örnekleri: Webhook rehberi.

Güvenlik

Anahtarı kaynak kodunuza gömmeyin; sunucunuzda ortam değişkeninde saklayın. Tarayıcıda (JavaScript) kullanmayın.
Her yazılıma ayrı anahtar ve yalnız gereken yetkiyi verin; kullanılmayan anahtarı programdan iptal edin (bir sonraki eşitlemede geçersiz olur).
Sunucuda anahtarın yalnız geri çözülemeyen özeti tutulur; tüm istekler HTTPS ile şifrelidir.

Eski API (1.0.209)

php/api.php?r=... uçları aynen çalışmaya devam eder; yeni entegrasyonlarda /api/v2/ kullanın.

Sorularınız için: info@pazaromatik.com.tr · 0850 242 09 03

PazarOMatik API: kendi yazılımınızı bağlayın