Access Token Nedir? Süre ve Yenileme

Access token, API'nin "bu istek yetkili" diye kabul ettiği geçici bir anahtardır. Çoğunlukla OAuth 2.0 akışı sonunda verilir. Uygulama bu belirteci her istekte, genellikle Authorization başlığında "Bearer" önekiyle gönderir.

API anahtarından farkı

Konu	API anahtarı	Access token
Ömür	Siz yenileyene kadar geçerli	Kısa; süresi dolar
Nasıl alınır	Satıcı panelinden kopyalanır	Bir yetkilendirme akışıyla üretilir
Kapsam	Çoğunlukla hesabın tüm API'si	Verilen izinlerle (scope) sınırlı
Sızarsa	Elle yenilenene kadar risk sürer	Süre dolunca kendiliğinden geçersizleşir

Platformlardan örnekler

Pazarama: API Key ve API Secret ile önce belirteç alınır; ürün ve sipariş istekleri "Bearer" başlığıyla bu belirteçle yapılır.
ikas: Mağazaya özel adresten client credentials ile belirteç alınır. Saystok'un ikas bağlantısı 401 alırsa belirteci yenileyip isteği bir kez daha dener.
Etsy: Kullanıcı izin verdikten sonra belirteç ve refresh token gelir. Belirteç süresi dolunca refresh token ile yenisi alınır.
Shopify: Saystok'un Shopify bağlantısı erişim belirtecini X-Shopify-Access-Token başlığıyla gönderir. Belirteç her istekte aynen gittiği için API anahtarı gibi korunmalıdır.

Süre dolunca ne olur?

Süresi dolmuş belirteçle yapılan istek 401 Unauthorized döner. İyi bir entegrasyon belirtecin bitiş zamanını bilir ve dolmadan önce yeniler. Belirteç yanıtında genellikle süre bilgisi (expires_in) saniye olarak gelir. Refresh token da geçersiz olursa kullanıcının yeniden izin vermesi gerekir.

Bu durumda entegrasyon yazılımı bağlantının koptuğunu açıkça göstermelidir. Sessizce başarısız olan bir bağlantı, sipariş ve stok güncellemelerinin saatlerce durmasına yol açabilir. Bağlantı uyarılarını düzenli kontrol edin.