Üç bilgi ne işe yarar?
Her bilginin ayrı bir görevi vardır. Hata aldığınızda hangisinin sorun çıkardığını bilmek, çözümü hızlandırır. Aşağıdaki örnek değerler sahtedir; kendi değerlerinizi kimseyle paylaşmayın.
| Bilgi | Görevi | İstekte nerede durur | Örnek (sahte) |
|---|---|---|---|
| Merchant ID | Mağazanın Hepsiburada'daki kimliği | Yolda ve Basic kullanıcı adında | SATICI_ID |
| Servis anahtarı (API Key) | Mağaza adına işlem yapma yetkisi | Basic şifresinde | API_KEY |
| User-Agent | İsteği gönderen uygulamanın adı | User-Agent başlığında | magazaadi_dev |
Merchant ID harf ve rakamlardan oluşan uzun bir kimliktir; mağaza adınızla aynı şey değildir. Servis anahtarı ise bir paroladır. İkisini aynı özenle saklayın. User-Agent gizli bir bilgi değildir ama portalda tanımlanan adla birebir aynı olmalıdır.
Merchant ID istekte iki kez geçer
Merchant ID yalnız kimlik doğrulamada kullanılmaz. Hepsiburada servisleri hangi mağazanın verisinin istendiğini yoldan okur. Yoldaki kimlik ile Basic başlığındaki kimlik aynı mağazaya ait olmalıdır.
| Servis | Örnek yol | Merchant ID'nin yeri |
|---|---|---|
| Listing (fiyat ve stok) | /listings/merchantid/SATICI_ID | Yol parçası |
| MPOP (katalog) | /product/api/products/all-products-of-merchant/SATICI_ID | Yol parçası |
| OMS (sipariş) | /orders/merchantid/SATICI_ID | Yol parçası |
| Katalog yükleme dosyası | merchant alanı | JSON içeriği |
Kimliksiz bir istek Listing servisinde 401 ve "Missing Credentials!" yanıtı alır. Yoldaki kimlik tanınmazsa yanıt 400 ve "Merchant ID is not specified." olur. Bu iki mesaj, sorunun başlıkta mı yolda mı olduğunu hemen gösterir. Servislerin tam listesi servis adresleri sayfasında.
Bilgiler nereden alınır?
Merchant ID, Hepsiburada satıcı panelinde hesap bilgilerinizde yer alır. Servis anahtarı ve User-Agent ise geliştirici portalında tanımlanan entegrasyonla ilişkilidir. Portal adımlarını Hepsiburada API bağlantısı kurulumu rehberi sırasıyla anlatır.
API erişimi bir onaya bağlıdır ve onay birkaç iş günü sürebilir. Bu yüzden Hepsiburada bağlantısını kurulum takviminin başına koymak iyi olur. Menü adları değişebildiği için güncel adımları Hepsiburada geliştirici portalında kontrol edin.
API anahtarının genel olarak ne olduğunu merak ediyorsanız pazaryeri API anahtarı nedir yazısı teknik olmayan bir dille anlatır.
Güvenli saklama
- Servis anahtarını tarayıcıda çalışan koda, mobil uygulamaya ya da herkese açık bir kod deposuna koymayın.
- İstekleri yalnız HTTPS üzerinden gönderin. Basic yönteminde anahtar şifrelenmez, yalnız kodlanır.
- Kayıt (log) dosyalarına Authorization başlığını yazmayın; hata ayıklarken başlığı maskeleyin.
- Anahtarı paylaştığınız her yazılım mağazanız adına işlem yapabilir. Paylaşımı yalnız güvendiğiniz entegrasyonla sınırlayın.
- Sızıntı şüphesinde anahtarı yenileme yolunu portalda kontrol edin ve bağlı yazılımlardaki değeri hemen güncelleyin.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 401 ve "Missing Credentials!" | Authorization başlığı gönderilmemiş | Basic başlığını her isteğe ekleyin |
| 401, başlık var | Merchant ID ya da anahtar yanlış, başta veya sonda boşluk var | Değerleri yeniden kopyalayın, boşlukları temizleyin |
| Ürün servisi çalışıyor, sipariş servisi 401 | Sipariş için panel şifresi ya da ayrı kullanıcı adı kullanılmış | Tüm servislerde Merchant ID ve servis anahtarını kullanın |
| Yanıt geliyor ama liste boş | Başka bir mağazanın ya da test hesabının Merchant ID'si | Yoldaki kimliği panelle karşılaştırın |
Kimlik doğrulamanın ayrıntısı Basic Auth sayfasında, tüm hata kodları hata kodları sayfasında.
Sık sorulanlar
Hepsiburada API Key nereden alınır?
Servis anahtarı, Hepsiburada geliştirici portalında tanımladığınız entegrasyonla ilişkilidir ve onaydan sonra kullanılabilir. Adımlar kurulum rehberinde sırasıyla anlatılıyor.
Merchant ID ile mağaza adı aynı şey mi?
Hayır. Merchant ID, harf ve rakamlardan oluşan uzun bir kimliktir ve API yollarında bu kimlik kullanılır. Mağaza adı yalnız vitrinde görünen addır.
Sipariş servisi için ayrı kullanıcı adı ve şifre gerekir mi?
Canlı kullanımda gerekmediği görüldü. Listing, MPOP ve OMS servislerinin hepsi Merchant ID ve servis anahtarından oluşan aynı Basic başlığıyla çalışır. Ayrı bir OMS kullanıcı adı ve şifresiyle yapılan istekler 401 aldı.
User-Agent gizli tutulmalı mı?
Gizli bir bilgi değildir. Ama portalda tanımlanan adla birebir aynı olmalıdır. Ayrıntılar User-Agent kuralı sayfasında.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı