Basic Auth, HTTP'nin en basit kimlik doğrulama yöntemidir. RFC 7617 ile tanımlanır. Yazılım her isteğe Authorization başlığı ekler. Başlığın değeri "Basic" kelimesi ve ardından kullanıcı adı ile şifrenin birleştirilip base64 ile kodlanmış hâlidir.
Adım adım
- Kullanıcı adı ile şifreyi aralarına iki nokta üst üste koyarak birleştirin: KULLANICI:SIFRE
- Bu metni base64 ile kodlayın.
- Başlığı şöyle gönderin: Authorization: Basic <kodlanmış değer>
Pazaryerlerinde kullanıcı adı ve şifre nedir?
| Platform | Kullanıcı adı | Şifre |
|---|---|---|
| Trendyol | API Key | API Secret |
| Hepsiburada | Merchant ID | Servis anahtarı |
| WooCommerce | Consumer key | Consumer secret |
| Pazarama (yalnız belirteç alırken) | API Key | API Secret |
Dikkat: satıcı paneline girdiğiniz e-posta ve şifre API'de çalışmaz. Trendyol'da satıcı ID bu başlığa girmez; adres yoluna ve User-Agent başlığına yazılır. Ayrıntılar için Trendyol kimlik doğrulama ve Hepsiburada Basic Auth sayfalarına bakın.
Base64 şifreleme değildir
Base64 yalnız bir kodlamadır; herkes saniyeler içinde geri çözebilir. Bu yüzden Basic Auth ancak HTTPS ile güvenlidir. HTTPS, isteği yolda şifreler ve başlığın üçüncü kişilerce okunmasını önler. Pazaryeri API adresleri HTTPS ile çalışır. Kendi yazdığınız bir webhook alıcısında da HTTP değil HTTPS kullanın.
Sık görülen hatalar
| Hata | Neden |
|---|---|
| 401 Unauthorized | Anahtar ya da secret yanlış; başta veya sonda boşluk kaldı |
| 401, ama bilgiler doğru | Canlı bilgiler test ortamında ya da test bilgileri canlıda kullanılıyor |
| 403 Forbidden | Kimlik doğru, ama yetki ya da Trendyol'da User-Agent eksik |
| Ara sıra 401 | Bilgiler panelden yenilendi, bazı sunucularda eskisi kaldı |
Basic Auth ile OAuth farkı
Basic Auth'ta uzun ömürlü anahtar her istekte gider. OAuth 2.0 ise önce kısa ömürlü bir belirteç alır, isteklerde onu kullanır. OAuth, kullanıcının şifresini üçüncü bir uygulamayla paylaşmadan izin vermesini de sağlar. Etsy gibi platformlar OAuth, Trendyol ve Hepsiburada ise Basic Auth kullanır.