API anahtarı (API key), yazılımın kimliğini doğrulayan koddur. Panel şifreniz insanlar içindir; API anahtarı ise yazılımlar içindir. Entegrasyon yazılımı her isteğe bu anahtarı ekler ve pazaryeri isteğin sizin mağazanız adına geldiğini anlar.
Pazaryerine göre adları
Her platform bu bilgilere farklı ad verir. Kendi rehber sayfalarımızda kullandığımız karşılıklar şöyledir:
| Platform | Verilen bilgiler | Nasıl kullanılır |
|---|---|---|
| Trendyol | Satıcı ID, API Key, API Secret | Key ve Secret Basic Auth başlığına, Satıcı ID adres yoluna ve User-Agent'a yazılır |
| Hepsiburada | Merchant ID, servis anahtarı, User-Agent | Merchant ID kullanıcı adı, servis anahtarı şifre olarak Basic Auth'a girer |
| N11 | App Key, App Secret | REST isteklerinde başlıkta, SOAP isteklerinde auth bloğunda gönderilir |
| Çiçeksepeti | API anahtarı | x-api-key başlığında gönderilir |
Ayrıntılı adımlar için Trendyol API bilgileri nasıl alınır ve Hepsiburada API bağlantısı kurulumu rehberlerine bakın.
Anahtar, secret ve ID farkı
- API anahtarı: Kim olduğunuzu söyler. Tek başına çoğu zaman yetmez.
- [API secret](/sozluk/api-secret): Anahtarın gerçekten size ait olduğunu kanıtlayan gizli parçadır.
- Satıcı ya da mağaza ID'si: Mağazanızın numarasıdır, gizli değildir. Adres yolunda ve başlıklarda geçer.
Güvenli kullanım
- Anahtarı yalnız güvendiğiniz yazılıma girin. Destek ekiplerine bile ekran görüntüsüyle göndermeyin.
- Çalışanınız ayrıldığında ya da bir sızıntıdan şüphelendiğinizde anahtarı panelden yenileyin. Yenilenen anahtarı bağlı yazılımlara tekrar girmeniz gerekir.
- Canlı ve test ortamı anahtarları farklıdır. Trendyol'da test anahtarları ayrı bir stage panelinden alınır; canlı anahtar testte 401 hatası verir.
Sık görülen hatalar
| Belirti | Olası neden |
|---|---|
| 401 Unauthorized | Anahtar ya da secret yanlış kopyalandı, başında veya sonunda boşluk kaldı |
| 403 Forbidden | Trendyol'da User-Agent başlığı eksik ya da hatalı |
| Bağlantı bir gün çalışıp sonra durdu | Anahtar panelden yenilendi, yazılımda eskisi kaldı |
Saystok, mağaza bağlantısı için girdiğiniz API bilgilerini veritabanında şifreli saklar. Bağlantı mantığının genel anlatımı pazaryeri API anahtarı nedir rehberinde.