Dökümantasyon

Çalışma prensibi

Birteg, ürünlerinizin tek doğru kopyasını tutar ve bunu bağladığınız satış kanallarına yansıtır. Merkezde duran kataloğa ana katalog diyoruz; her pazaryeri bağlantısı bu kataloğun o kanaldaki görünümüdür.

Kanalı bağlarsınız. Pazaryeri veya mağaza kimlik bilgilerinizi girersiniz; bilgiler şifreli olarak saklanır.
Katalog eşlenir. Kanaldaki mevcut ürünleriniz içe aktarılır ve ana katalogdaki ürünlerle SKU/barkod üzerinden eşleştirilir.
Kurallar tanımlanır. Her kanal için fiyat politikası (yüzde, sabit fark veya sabit fiyat) ve stok politikası belirlersiniz.
Değişiklik yayılır. Ana katalogda bir fiyat veya stok değiştiğinde, kuralları uygulanmış hâliyle ilgili kanallara gönderilir.
Siparişler toplanır. Kanallardan gelen siparişler tek listede birleşir.

Yön önemlidir.

Fiyat ve stok ana katalogdan kanala doğru akar. Bir pazaryeri panelinden veya mağaza yönetiminden elle yaptığınız fiyat değişikliği ana kataloğu güncellemez; bir sonraki senkronizasyonda ana katalogdaki fiyat geçerli olur. Kalıcı değişiklikleri Birteg üzerinden yapın.

Desteklenen kanallar

Pazaryerleri kendi API'leri üzerinden, kendi siteniz ise mağaza eklentisi veya XML/özel API ile bağlanır.

Trendyol Hepsiburada Idefix N11 Pazarama PttAVM Temu Amazon Modanisa MediaMarkt Kendi siteniz XML kanalı Özel API

Mağaza eklentileri OpenCart, WooCommerce ve PrestaShop için hazır paket olarak sunulur. Eklenti, mağazanızda yalnızca Birteg'nin okuyup yazacağı uçları açar; mağaza yönetim paneline erişim istemez.

Senkronizasyon modeli

Senkronizasyon iş kuyruğu üzerinden yürür. Bir işlem tetiklendiğinde bir iş oluşturulur, sıraya alınır ve arka plan çalışanı tarafından işlenir. Böylece pazaryeri yavaşladığında veya geçici hata verdiğinde portal beklemez.

İş türü	Yön	Ne yapar
`product_import`	Kanal → Birteg	Kanaldaki ürünleri okur, ana katalogla eşleştirir.
`product_publish`	Birteg → Kanal	Ürünü kanalda yayına alır.
`price_sync`	Birteg → Kanal	Fiyat politikasını uygulayıp kanal fiyatını günceller.
`inventory_sync`	Birteg → Kanal	Stok tamponunu uygulayıp kanal stokunu günceller.
`order_import`	Kanal → Birteg	Yeni siparişleri çeker.

Başarısız işler yeniden denenir; kalıcı hatalar Sorunlar ekranında toplanır. Her işin hangi ürünlerde başarılı, uyarılı veya başarısız olduğu iş detayında satır satır görünür.

API kullanımı

API, çalışma alanınızdaki veriyi kendi sistemlerinize okumak için kullanılır. Kimlik doğrulama Bearer anahtarı ile yapılır.

Anahtar oluşturma

Portalda API Anahtarları ekranından anahtar üretirsiniz. Anahtarın tam değeri yalnızca oluşturulduğu anda bir kez gösterilir; sonrasında yalnızca ön eki görünür. Kaybederseniz yenisini üretip eskisini iptal edin.

İstek

curl https://birteg.com/api/v1/products \
  -H "Authorization: Bearer sk_live_ANAHTARINIZ"

Yanıt

{
  "data": [
    {
      "id": 1042,
      "sku": "DPH-0001",
      "name": "Trail Shell Jacket",
      "base_price": "4299.00",
      "stock": 42,
      "status": "active",
      "category": "Apparel",
      "updated_at": "2026-08-25 20:14:03"
    }
  ],
  "meta": { "count": 1 }
}

Kapsam.

Anahtar yalnızca kendi çalışma alanınızın verisine erişir. Başka bir müşterinin verisi hiçbir anahtarla görünmez. Tüm API çağrıları hesabınızın istek loglarına yazılır.

Uç noktalar

Metot	Yol	Açıklama
GET	`/api/v1/products`	Ana katalogdaki ürünler, en son güncellenenden başlayarak (en fazla 100 kayıt).
GET	`/api/v1/integrations`	Kanal bağlantılarınız, durumları ve son senkronizasyon zamanları.
POST	`/hooks/incoming/{workspace}/{integration}`	Kendi sisteminizden Birteg'ye olay bildirmek için (aşağıya bakın).
GET	`/feeds/public/{feed}/{key}`	Oluşturduğunuz XML/CSV ürün feed'inin herkese açık adresi.

API şu an okuma odaklıdır. Yazma işlemleri portal ve kanal bağlantıları üzerinden yürür.

Webhooklar

Kendi sisteminizde bir şey değiştiğinde Birteg'yi tetikleyebilirsiniz. İstek gövdesindeki event alanı hangi işin kuyruğa alınacağını belirler.

curl -X POST https://birteg.com/hooks/incoming/calisma-alaniniz/12 \
  -H "Content-Type: application/json" \
  -d '{"event":"product.updated"}'

event	Tetiklenen iş	Yön
`product.updated`	`product_update`	Sizden okur
`order.created`	`order_import`	Sizden okur
`price.updated`	`price_sync`	Size yazar
`stock.updated`	`inventory_sync`	Size yazar

Dikkat: price.updated ve stock.updated ters yönde çalışır.

Bu iki olay, Birteg'nin ana katalogdaki fiyat/stoku size göndermesini tetikler. "Mağazamda fiyat değişti, gelip alın" demek istiyorsanız product.updated kullanın; aksi hâlde mağazanızdaki değer ana katalogdaki değerle değiştirilir.

Hata kodları

Kod	Anlamı	Ne yapmalı
`401`	Anahtar yok, hatalı veya iptal edilmiş.	Authorization başlığını ve anahtarın durumunu kontrol edin.
`403`	Bu kaynak için yetki yok.	Anahtarın ait olduğu çalışma alanını doğrulayın.
`404`	Kayıt veya çalışma alanı bulunamadı.	Yoldaki tanımlayıcıları kontrol edin.
`419`	Oturum güvenlik anahtarının süresi doldu.	Sayfayı yenileyip formu tekrar gönderin (yalnızca portal formları).
`422`	Gövde geçersiz veya eksik.	JSON biçimini ve zorunlu alanları kontrol edin.
`429`	Çok fazla istek.	Bekleyip tekrar deneyin; istek sıklığınızı düşürün.

Güvenlik önerileri

Hesabınızın güvenliği büyük ölçüde erişim bilgilerinin nasıl saklandığına bağlıdır. Aşağıdakileri uygulamanızı öneririz.

İki adımlı doğrulamayı (2FA) açın. Parola tek başına yeterli bir savunma değildir. Özellikle sahibi ve yönetici rolündeki kullanıcılar için iki adımlı doğrulamayı etkinleştirmenizi öneririz.
Her entegrasyon için ayrı anahtar üretin. Tek bir anahtarı birden fazla sistemde kullanmayın; sızıntı durumunda hangisinin iptal edileceği belirsiz kalır.
Anahtarları kaynak koduna yazmayın. Ortam değişkeni veya gizli anahtar yöneticisi kullanın. Genel depolara (GitHub vb.) gönderilen anahtarlar dakikalar içinde taranıp kullanılabilir.
Anahtarları düzenli olarak yenileyin. Ekipten biri ayrıldığında veya bir anahtarın nerede kullanıldığından emin olamadığınızda iptal edip yenisini üretin.
Ekip erişimini rolle sınırlayın. Yalnızca rapor görmesi gereken kullanıcıya salt okunur rol verin.
Webhook adreslerinizi tahmin edilemez tutun ve yalnızca HTTPS üzerinden yayınlayın.
Şüpheli durumda API isteklerinizi inceleyin. Portaldaki istek logları hangi anahtarın ne zaman ne çağırdığını gösterir.

Bizim tarafımızda ne yapılıyor?

Pazaryeri kimlik bilgileriniz şifrelenmiş olarak saklanır ve arayüzde tam hâliyle gösterilmez. Her sorgu çalışma alanınızla sınırlandırılır. Loglarda kimlik bilgileri maskelenir. Portal formları CSRF korumalıdır ve yönetimsel işlemler rol kontrolünden geçer.

Sorumluluk sınırları

API anahtarınızın paylaşımından doğan sonuçlardan sorumlu değiliz.

API anahtarı, çalışma alanınızın verisine erişim yetkisi taşıyan bir kimlik bilgisidir ve parolanız gibi korunmalıdır. Anahtarın üçüncü kişilerle paylaşılması, herkese açık bir depoya yüklenmesi, güvenli olmayan bir ortamda saklanması veya yetkisiz kişilerce ele geçirilmesi hâlinde doğacak veri erişimi, veri kaybı ve bunlardan kaynaklanan zararlardan Birteg sorumluluk kabul etmez. Anahtarın kime verildiğini ve nerede kullanıldığını takip etmek hesap sahibinin yükümlülüğündedir.

Pazaryeri kimlik bilgileri. Kanal bağlantısı için girdiğiniz bilgilerin doğruluğu ve bu bilgilerin size ait yetkili bir hesaba ait olması sizin sorumluluğunuzdadır.
Kanal kuralları. Pazaryerlerinin kendi listeleme, fiyat ve içerik kuralları geçerlidir. Bu kuralların ihlalinden doğan mağaza kısıtlamalarından Birteg sorumlu değildir.
Üçüncü taraf kesintileri. Pazaryeri veya mağaza altyapınızdaki kesinti ve API değişikliklerinin yol açtığı gecikmeler kontrolümüz dışındadır; bu durumlar Pazaryeri Sağlığı ekranında raporlanır.
Yetkisiz kullanıcı işlemleri. Çalışma alanınıza davet ettiğiniz kullanıcıların yaptığı işlemler hesap sahibinin sorumluluğundadır. Ayrılan ekip üyelerinin erişimini kapatın.
Fiyat ve stok doğruluğu. Tanımladığınız fiyat ve stok kuralları girdiğiniz şekilde uygulanır. Yanlış tanımlanmış bir kuralın kanallara yansımasından doğan ticari sonuçlar sizin sorumluluğunuzdadır; toplu işlemler öncesi önizlemeyi kontrol etmenizi öneririz.

Bu sayfa bilgilendirme amaçlıdır ve sözleşmenizin yerine geçmez. Bağlayıcı hükümler hizmet sözleşmesinde ve gizlilik politikasında yer alır.

Birteg nasıl çalışır?