İki bilgi ve görevleri
Pazarama entegrasyonu iki gizli değerle başlar. Aşağıdaki örnek değerler sahtedir; kendi değerlerinizi kimseyle paylaşmayın.
| Bilgi | OAuth2'deki karşılığı | Görevi | Örnek (sahte) |
|---|---|---|---|
| API Key | client_id | Token isteğinde kullanıcı adı | API_KEY |
| API Secret | client_secret | Token isteğinde şifre | API_SECRET |
Pazarama'da Trendyol ya da idefix'teki gibi ayrı bir satıcı ID'si istek yoluna yazılmaz. Canlıda çalışan entegrasyonda ürün, stok, fiyat ve sipariş istekleri satıcı ID'si olmadan, yalnız token ile yapılır. Hangi mağazanın verisinin istendiği token'a bağlıdır.
Adım adım
- İş Ortağım paneline giriş yapın.
- Sağ üstten Hesabım menüsünü açın ve Hesap Bilgileri sayfasına girin.
- Entegrasyon Bilgileri sekmesine geçin.
- API Key ve API Secret değerlerini kopyalayın.
- Değerleri kullanacağınız yazılıma girin ve bağlantıyı test edin.
Menü adları zamanla değişebilir. Panelin üst menüsündeki Entegrasyon bağlantısı, Pazarama'nın entegrasyon dokümanını açar. Doküman tarayıcıda çalışan bir uygulama olarak yayımlandığı için bu rehberdeki uç noktalar canlıda çalışan bir entegrasyonun kodundan doğrulandı.
API Secret süresi
API Secret bir yıl geçerlidir. Süre dolunca token isteği reddedilir ve bütün servisler durur: stok gitmez, siparişler gelmez. Yeni Secret'ı aynı Entegrasyon Bilgileri sekmesinden alıp bağlı tüm yazılımlarda değeri güncellemeniz gerekir.
| Olay | Belirti | Yapılacak |
|---|---|---|
| Secret süresi doldu | Token isteği 400 ya da 401 alıyor | Panelden yeni Secret alın |
| Yeni Secret alındı | Eski Secret'ı kullanan yazılım bağlanamıyor | Tüm yazılımlarda değeri güncelleyin |
| Token süresi doldu | API isteği 401 alıyor | Yeni token alın; panel işlemi gerekmez |
Yenileme tarihini takviminize not edin. Bağlantı aylarca sorunsuz çalışıp bir gün aniden kesilirse ilk bakılacak yer Secret'ın süresidir.
Güvenli saklama
- API Key ve API Secret'ı tarayıcıda çalışan koda, mobil uygulamaya ya da herkese açık kod deposuna koymayın.
- Kayıt dosyalarına Authorization başlığını ve token'ı yazmayın.
- Anahtarı verdiğiniz yazılım mağazanız adına stok ve fiyat değiştirebilir, siparişleri okuyabilir; yalnız güvendiğiniz entegrasyona verin.
- Sızıntı şüphesinde panelden Secret'ı yenileyin ve bağlı yazılımları güncelleyin.
API anahtarının ne olduğunu teknik olmayan bir dille merak ediyorsanız pazaryeri API anahtarı nedir yazısına bakın.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Token isteği 400 ya da 401 | Key ya da Secret yanlış veya süresi dolmuş | Değerleri panelden yeniden kopyalayın; gerekirse Secret'ı yenileyin |
| Bağlantı aylarca çalıştı, sonra kesildi | Secret'ın süresi doldu | Yeni Secret alın, kaydı güncelleyin |
| Key ile Secret yer değiştirdi | Basic başlıkta sıra ters | Önce API Key, sonra API Secret |
| Değer doğru görünüyor ama reddediliyor | Başta ya da sonda boşluk | Değerleri kırpıp yeniden yapıştırın |
Token isteğinin ayrıntısı token alma sayfasında.
Sık sorulanlar
Pazarama API Key nereden alınır?
İş Ortağım panelinde Hesabım, Hesap Bilgileri sayfasındaki Entegrasyon Bilgileri sekmesinden. API Key ve API Secret aynı sekmede yer alır.
Pazarama'da satıcı ID'si gerekir mi?
Canlıda çalışan entegrasyonda gerekmez. İstekler token ile yapılır; mağaza bilgisi token'a bağlıdır.
Pazarama API Secret ne kadar geçerli?
Bir yıl. Süre dolunca panelden yeni Secret alınır ve bağlı yazılımlardaki değer güncellenir.
API Key ve Secret doğrudan isteklerde kullanılır mı?
Hayır. Bu iki değerle önce kimlik sunucusundan token alınır; ürün, stok ve sipariş isteklerinde Bearer token gönderilir.
Kaynaklar
İlgili Pazarama API konuları
Son güncelleme: 27.10.2026 · Pazarama API rehberinin tamamı