Entegrasyoner Public API — Genel Bakış

API entegratörlerine açık olan REST endpoint'leri burada dokümante edilir. Tüm istekler https://api.entegrasyoner.com/v1/... altında, JSON gövdesiyle çalışır.

Hızlı başlangıç: portal'a tarayıcıyla bir kere giriş yap → API Bağlantıları → Yeni Bağlantı → "Web Servis (API)" → bağlantı adı (örn. "Mikro ERP") gir → modal'da gösterilen entgr_xxxxx anahtarını tek seferlik kopyala → ERP / cron config'ine yapıştır → tüm isteklere Authorization: Bearer entgr_xxxxx ekle. Detay: Authentication.

İçerik

Başlangıç

• Hata Kodları — standart hata formatı, HTTP kodları, validation mesajları

Endpoint'ler

• Authentication — API Anahtarı oluşturma + Bearer header + /v1/me + rotate / revoke
• Products — Ürün CRUD, resim (ekle/sırala/sil), stok lokasyonları, KDV oranları, marka & kategori auto-resolve, effective-targets (yayın hedefi önizleme)
• Orders — siparişleri listele/detaylandır, polling stratejisi
• Brands — marka listele, oluştur, güncelle, sil
• Categories — kategori ağacı listele, oluştur (parent ile), güncelle, sil
• Toplu İşlemler — Excel/CSV içe (import) ve dışa (export) aktarım

Referans

• Pazaryerleri — kanallar (pazaryeri / e-ticaret / ERP), çoklu mağaza, fiyat markup, webhook
• SSS — sık sorulan sorular
• Postman Collection — token'ı gir, doğrudan test et

Hata davranışı (özet)

HTTP	Anlam
200 OK	Listeleme, güncelleme, silme, indirme — başarılı. Silmede JSON mesaj döner (örn. {"message":"Ürün silindi."})
201 Created	Yeni kayıt oluşturuldu, response içinde id
202 Accepted	İş kuyruğa alındı (örn. bulk import)
401 Unauthorized	Token eksik veya geçersiz
403 Forbidden	Tenant izinsiz erişim
404 Not Found	Kayıt bulunamadı
409 Conflict	İş kuralı çakışması
422 Unprocessable Entity	Validation hatası — errors objesi içinde alan bazlı detay
500 Server Error	Beklenmeyen sunucu hatası — log'a düşer, retry edilebilir

Detay: errors.

Versiyonlama

URL'de v1 taşıyoruz. Geriye uyumsuz değişiklikler için v2 açılır; eski sürüm en az 6 ay yaşar.

Hız sınırı (rate limit)

Tenant başına dakikada 60 istek. Aşılırsa 429 Too Many Requests + Retry-After header döner. Detay: errors.

Sürüm geçmişi

• 2026-05-01 — v1 yayında.