Geliştirici kullanıcı adı bir giriş bilgisi değil, imzadır
Hepsiburada kurulumunda üç alan istenir ve üçüncüsü kafa karıştırır: Entegrasyon Geliştirici Kullanıcı Adı. Bu bir giriş bilgisi değildir — Hepsiburada'ya giden her isteğin User-Agent başlığında taşınır ve platform, isteğin hangi entegratörden geldiğini bu alandan okur. Yanlış yazıldığında dönen hata çoğu zaman yetkisizlik der; insan şifreyi kontrol etmeye başlar, oysa sorun imzadadır.
Mağaza ID bir UUID'dir — harf ve rakam karışımı uzun bir dizi; Trendyol'daki gibi kısa bir sayı beklemeyin. Servis Anahtarı ise Basic Auth şifresi olarak kullanılır. Üçü de satıcı panelinde Hesabım > Entegrasyon Bilgileri altında, aynı ekranda durur.
Opsiyonel webhook alanlarını boş bırakırsanız ne olur?
Kurulum ekranında üç opsiyonel alan daha vardır: webhook token'ı, webhook kullanıcı adı ve şifresi. Bunlar, sipariş ve talep bildirimleri size ulaşırken doğrulanabilsin diye durur. Boş bırakırsanız bağlantı çalışmaya devam eder — doğrulama, gelen verinin içindeki mağaza kimliği üzerinden yapılır. Doldurduğunuzda ise her bildirim ayrıca kimlik kontrolünden geçer.
Beklentiyi doğru kurmak için bir nokta daha: kestiğiniz faturayı Hepsiburada'ya gönderebilirsiniz, ancak kargo etiketi PDF'i bu bağlantı üzerinden gelmez. Etiket tarafı kargo firmasının kendi entegrasyonundan yürür. Ayrıca ürün eşleştirmesi yalnız stok kodu üzerinden yapılır; barkodla eşleştirme bu platformda yoktur, dolayısıyla stok kodlarınızın tutarlı olması burada daha kritiktir.
Hepsiburada API'sine bağlanmak: neyin nereden alındığı
Hepsiburada API'sine bağlanmak için üç değer gerekir ve üçü de satıcı panelinde Hesabım > Entegrasyon Bilgileri altında, aynı ekranda durur: Mağaza ID, geliştirici kullanıcı adı ve Servis Anahtarı. Ayrı bir geliştirici portalına kaydolmanız, uygulama oluşturmanız ya da onay beklemeniz gerekmez — Amazon ve eBay'den ayrıldığı nokta budur.
Kimlik doğrulaması Basic Auth ile yapılır: Mağaza ID kullanıcı adı, Servis Anahtarı şifre yerine geçer. Geliştirici kullanıcı adı ise kimlik değil, her isteğin User-Agent başlığında taşınan bir imzadır. Bu üçlü doğru kurulduğunda sipariş çekme, stok ve fiyat güncelleme, iade yönetimi ve müşteri soruları tek bağlantı üzerinden akar.
Kendi entegrasyonunu yazmayı düşünen bir geliştirici için asıl maliyet ilk bağlantı değil, sonrasıdır: hız sınırları, sayfalama, sipariş durum geçişleri, iade akışı ve API sürümü değiştiğinde uyum. Stokzone bu katmanı hazır sunar; siz Hepsiburada'nın kendi kurallarını değil, kendi ürününüzü düşünürsünüz.
