Kimlik doğrulama
Tüm servisler HTTP Basic yöntemini kullanır: kullanıcı adı Merchant ID, şifre servis anahtarıdır (API Key). İkisi iki nokta ile birleştirilip Base64 ile kodlanır ve Authorization başlığına yazılır. Her isteğe ayrıca portalda tanımlı entegrasyon adını taşıyan bir User-Agent başlığı eklenir. Satıcı paneli e-postası ve şifresi API'de çalışmaz. Ayrıntı: kimlik doğrulama ve User-Agent kuralı.
Servisler ve temel adresler
| Servis | Temel adres | Ne için |
|---|---|---|
| Listing | https://listing-external.hepsiburada.com | Listelemeler, stok ve fiyat |
| MPOP | https://mpop.hepsiburada.com | Ürün yükleme, kategori, özellik, mağaza ürünleri |
| OMS | https://oms-external.hepsiburada.com | Siparişler, paketler, iptaller |
Merchant ID yollarda da geçer: /listings/merchantid/SATICI_ID, /orders/merchantid/SATICI_ID gibi. Hangi işin hangi yola gittiği servis adresleri sayfasında.
Test (SIT) ve canlı ortam
Entegrasyon canlıya açılmadan önce test ortamında (SIT) denenir. Test adresleri canlı adreslerin -sit ekli karşılıklarıdır; örneğin listing-external-sit.hepsiburada.com. Her ortamın kendi kimlik bilgileri olur. Adresleri ve kimliği ayar dosyasında tutun ki ortam değiştirmek kod değişikliği gerektirmesin. Ayrıntı: SIT ve canlı ortam.
İstek sınırları ve sayfalama
Güncel istek sınırları resmî dokümanda yayımlanır; bu rehber sayı vermez. Sayfalama servise göre değişir: Listing ve OMS offset ile limit, MPOP page ile size kullanır. MPOP mağaza ürün listesi sayfa başına en fazla 100 kayıt döndürür ve sayfa numarası 0'dan başlar. Paket durum listeleri tarih filtresi almaz. Ayrıntı: istek sınırları ve sayfalama.
Sürümler ve eşzamansız işlemler
Bu rehberdeki yollarda sürüm numarası yoktur; değişiklikleri geliştirici portalındaki duyurulardan izleyin. Stok, fiyat ve ürün yüklemeleri eşzamansızdır: ilk yanıt yalnız bir takip kimliği döndürür, sonuç ayrıca sorgulanır. 200 yanıtı işin yapıldığı anlamına gelmez.
Genel hata kodları
| Kod ya da mesaj | Hepsiburada'da görülen anlamı |
|---|---|
| 200, işlenen kayıt yok | Stok yüklemesinde alan adları yanlış yazılmış |
| 400 "Merchant ID is not specified." | Yoldaki Merchant ID tanınmadı |
| 401 "Missing Credentials!" | Authorization başlığı yok |
| 401 | Yanlış kimlik ya da eski sipariş yolu kalıbı |
| 404 | Var olmayan yol |
| 500 | Katalogda emoji ya da sembol; JSON'un dosya yerine gövde olarak gönderilmesi |
| ListingNotFound | SKU için listeleme yok |
| DuplicateHepsiburadaSkuSpecified | Aynı SKU pakette iki kez; paketin tamamı reddedilir |
Tüm hatalar ve çözümleri hata kodları sayfasında.
Hepsiburada API işlemleri
Genel
Ürün ve katalog
Stok ve fiyat
Sipariş ve paket
Webhook
Sık sorulanlar
Hepsiburada API'de kullanıcı adı ve şifre nedir?
Kullanıcı adı Merchant ID, şifre servis anahtarıdır (API Key). İkisi Basic Auth başlığında birleşir. Satıcı paneli e-postası ve şifresi API'de çalışmaz.
Hepsiburada API kaç servisten oluşur?
Ürün, stok ve sipariş işleri üç servise bölünür: Listing (fiyat ve stok), MPOP (katalog) ve OMS (sipariş ve paket). Üçü de aynı kimlik bilgilerini kullanır.
Hepsiburada stok güncellemesi anında yansır mı?
Hayır, istek önce kabul edilir sonra işlenir. Yanıttaki takip kimliğiyle sonucu sorgulayıp Done durumunu ve boş hata listesini görmeden güncellemeyi başarılı saymayın.
Hepsiburada webhook gönderir mi?
Evet. Yeni sipariş, iptal, kargo, teslim, paket oluşturma, adres değişikliği ve paket bozma olaylarını belirlediğiniz adrese gönderir. Paket bozma bildirimi PUT ile gelir.
Hepsiburada iade ve müşteri sorularını Saystok yönetir mi?
Hayır. Saystok'ta müşteri soruları yalnız Trendyol ve N11, iade yönetimi yalnız Trendyol ve WooCommerce için çalışır. Hepsiburada'da bu işler satıcı panelinde kalır; ilgili API uçları için resmî dokümana bakın.