User-Agent, her HTTP isteğinde gönderilebilen bir başlıktır ve isteği hangi yazılımın attığını söyler. Tarayıcılar burada kendi adını ve sürümünü yazar. MDN'nin açıklamasına göre sunucular bu bilgiyi istemciyi tanımak için kullanır. Pazaryeri API'lerinde ise başlık, entegrasyonun kimliği hâline gelir.
Trendyol'da User-Agent
Trendyol her istekte User-Agent ister ve bu başlık olmayan istekleri 403 hatasıyla engeller. Biçim satıcı ID ile başlar:
| Durum | Biçim | Örnek |
|---|---|---|
| Yazılımı satıcı kendisi yazdı | SATICI_ID - SelfIntegration | 1234 - SelfIntegration |
| Entegratör firma kullanılıyor | SATICI_ID - FirmaAdi | 1234 - OrnekFirma |
Entegratör adı alfanümerik olmalı ve en fazla 30 karakter olmalıdır. Ayrıntı: Trendyol kimlik doğrulama ve User-Agent.
Hepsiburada'da User-Agent
Hepsiburada'da User-Agent, geliştirici portalında tanımlanan entegrasyonun adıdır. Başlık boş kalırsa ya da portaldaki adla uyuşmazsa bağlantı testi başarısız olur. Kütüphanelerin varsayılan değerini (ör. bir HTTP kütüphanesinin kendi adı) olduğu gibi bırakmamak gerekir. Ayrıntı: Hepsiburada User-Agent kuralı.
Neden önemli?
- Trafik ayrımı: Pazaryeri, hangi isteğin hangi entegrasyondan geldiğini görür. Sorun olduğunda doğru tarafa ulaşır.
- Limit ve izleme: İstekler entegrasyon bazında izlenebilir.
- Güvenlik: Tanımsız ya da sahte istemcileri ayıklamaya yardım eder.
Sık hatalar
- Başlığı hiç göndermemek; Trendyol'da 403 sonucunu verir.
- Satıcı ID yerine API Key yazmak.
- Tire etrafındaki boşlukları atlamak ya da firma adında Türkçe karakter ve boşluk kullanmak.
- Test ortamında doğru, canlıda farklı başlık göndermek.
Hata ayıklarken önce isteğin gerçekte hangi başlıkla gittiğine bakın. Bazı HTTP kütüphaneleri başlığı kendi değeriyle ezer. Trendyol'da hatalı kimlik bilgisi 401 döndürür ve mesajda ClientApiAuthenticationException görülür; 403 ise çoğunlukla User-Agent sorununa işaret eder.
Saystok, Trendyol isteklerine "SATICI_ID - SelfIntegration" biçiminde başlık ekler; Hepsiburada isteklerinde mağazanın tanımlı User-Agent değerini kullanır.