User-Agent nedir?
User-Agent, isteği gönderen uygulamayı tanıtan bir istek başlığıdır. MDN'ye göre bu başlık sunucuların isteği yapan uygulamayı, işletim sistemini, üreticiyi ve sürümü tanımasını sağlayan karakteristik bir metindir (MDN: User-Agent).
Tarayıcılar bu başlığı kendiliğinden doldurur. Sunucudan sunucuya istek atan kodda ise değeri siz belirlersiniz. Hepsiburada bu başlığı, isteğin hangi entegrasyondan geldiğini anlamak için kullanır. Bu yüzden değer, portalda tanımlanan entegrasyon adıyla aynı olmalıdır.
Doğru ve yanlış örnekler
| User-Agent değeri | Durum | Açıklama |
|---|---|---|
| magazaadi_dev | Doğru biçim | Portaldaki entegrasyon adıyla birebir aynı |
| Boş başlık | Hatalı | Kütüphane kendi varsayılanını koyar ya da hiç göndermez |
| axios, python-requests, curl gibi varsayılanlar | Hatalı | Entegrasyonu tanıtmaz |
| Tarayıcı taklidi (Mozilla/5.0 ile başlayan) | Önerilmez | Entegrasyon adını taşımaz |
| Portaldaki addan farklı yazım | Hatalı | Harf, alt çizgi ya da ek farkı eşleşmeyi bozar |
Değeri elle yazmak yerine portaldan kopyalayın. Alt çizgi ile tire, büyük harf ile küçük harf gibi farklar gözden kaçar.
Kodda nereye yazılır?
User-Agent, Authorization gibi her istekte gönderilen bir başlıktır. En güvenli yol, tek bir HTTP istemcisi kurup iki başlığı orada sabitlemektir. Böylece Listing, MPOP ve OMS servislerinin birinde başlığı unutma riski kalmaz.
- Listing, MPOP ve OMS için aynı değeri kullanın.
- Katalog yüklemesi gibi multipart/form-data isteklerinde içerik türü değişir ama User-Agent aynı kalır.
- Değeri koda gömmek yerine ayar dosyasında ya da mağaza bilgisinde tutun; değiştiğinde yeniden derleme gerekmez.
- Hata kayıtlarında User-Agent'ı yazdırmak sorun değildir; gizli bilgi değildir. Ama Authorization başlığını asla yazdırmayın.
- Bazı kütüphaneler başka bir adrese yönlendirmede Authorization başlığını düşürür. Yeniden deneme ve yönlendirme mantığında iki başlığın da korunduğunu sınayın.
Başlıkların gerçekten gittiğini görmek için ilk denemede isteği bir kayıt aracıyla yakalayın. Authorization değerini maskeleyip User-Agent'ı olduğu gibi kontrol edin. Bu basit adım, saatler süren tahmine dayalı hata aramasını önler.
Birden fazla mağaza yönetiyorsanız
Entegratör yazılımları çok sayıda mağazaya hizmet verir. Her mağazanın kendi Merchant ID'si ve servis anahtarı vardır. User-Agent değeri de mağaza bilgisiyle birlikte saklanmalıdır. Tek bir sabit değer kullanmak, portalda farklı tanım yapan mağazalarda bağlantıyı bozar.
Kurulum ekranında User-Agent alanını boş bırakan mağazalar için yazılımın bir varsayılan değeri olabilir. Bu değer yazılımın kendi entegrasyon adıdır; mağazanın portaldaki tanımıyla aynı olmayabilir. Kendi adınızı yazmak en temiz yoldur.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Kimlik doğru, bağlantı testi yine başarısız | User-Agent portaldaki adla uyuşmuyor | Değeri portaldan kopyalayıp yeniden deneyin |
| Bazı servisler çalışıyor, biri çalışmıyor | Bir istemcide başlık unutulmuş | Ortak istemci kullanın |
| Testte çalıştı, sunucuda çalışmıyor | Sunucudaki ayar dosyasında değer eksik | Ortam değişkenini kontrol edin |
Kimlik bilgileri doğruysa sıradaki şüpheli User-Agent'tır. Hata mesajı her zaman bu başlığı işaret etmeyebilir. Kimlik tarafını Basic Auth sayfasındaki adımlarla eleyin.
Sık sorulanlar
User-Agent değerimi nereden öğrenirim?
Geliştirici portalında tanımladığınız entegrasyonun adıdır. Kurulum adımları Hepsiburada API bağlantısı rehberinde.
Tarayıcı User-Agent değeri yazsam olur mu?
Önerilmez. Bu değer entegrasyonunuzu tanıtmaz. Portalda tanımlanan adı birebir kullanın.
Her serviste farklı User-Agent mı kullanılır?
Hayır. Listing, MPOP ve OMS servislerine aynı değer gönderilir. Değeri tek bir istemcide sabitlemek en güvenli yoldur.
User-Agent yanlışsa hangi hatayı alırım?
Bağlantı testi başarısız olur. Mesaj her zaman nedeni söylemeyebilir. Önce kimlik bilgilerini, sonra User-Agent değerini kontrol edin.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı