Kimlik doğrulama
- Authorization: ApiKey
- API anahtarı yalnızca POST /api/v1/auth/token isteğinin Authorization başlığında gönderilir. Anahtarı JSON içine, URL'ye veya sorgu parametrelerine koymayın.
- Authorization: Bearer
- Kaynak isteklerinde döndürülen belirteci kullanın ve expires_at değerine göre yenileyin; expires_in saniye cinsindendir.
Neden önce token alınır?
API anahtarı token almak için kullanılır. Token 15 dakika geçerlidir ve birden fazla istekte kullanılabilir. Kaynaklara yalnızca tokenı Authorization: Bearer başlığında gönderin.
Normal istekler API anahtarını içermez. Sızan bir token, en fazla geçerlilik süresi dolana kadar erişim sağlar. Çalınan API anahtarı ise yeni tokenlar alınmasına hâlâ izin verebilir.
Token ne kadar süre geçerlidir?
- expires_in
- Düzenlendiği andan itibaren 900 saniye, yani 15 dakika. İstek göndermek geçerlilik süresini uzatmaz.
- expires_at
- UTC olarak sona erme zamanı. Geçerli erişim kısıtlamaları tokenı daha önce engelleyebilir.
Ne zaman yeni token alınmalı?
Aynı tokenı birden fazla istekte kullanın ve expires_at öncesinde yenisini alın. Her işlemden önce token istemeyin. Yeni tokenı API anahtarıyla alın.
Erişim reddi ve yeniden deneme
- 401
- 401 her zaman tokenın süresinin dolduğu anlamına gelmez. Süresi dolduysa yenisini alın ve okuma isteğini en fazla bir kez tekrarlayın. Token alma isteği 401 döndürürse anahtarı kontrol edin ve otomatik denemeleri durdurun.
- 403
- 403 durumunda izinleri, IP kısıtlamalarını ve planı kontrol edin. Yeni token, iptal edilen erişimi geri getirmez.
IP kısıtlamaları
- Erişim belirteci, anahtarın güncel izinlerini, mağazanın haklarını, anahtarın iptalini veya IP kısıtlamalarını geçersiz kılmaz.
- Gerektiğinde anahtarı entegrasyonun kaynak adresleriyle sınırlandırın.
- Yönetici bu listeyi düzenleyebilir; en fazla 32 adres kabul edilir.
Anahtar yönetimi
- API anahtarı yönetimi, entegrasyonun kaynak izinlerinden ayrıdır.
- Gruplara anahtarları görüntüleme, oluşturma, düzenleme veya silme yetkilerini yalnızca owner verebilir.
- Yetkili bir grubun üyesi yalnızca gruba verilen işlemleri gerçekleştirebilir.
İstek hızı sınırları
Engine ≥ 4.143.0. Her token yanıtı, verildiği anda geçerli mağaza politikasından data.rate_limits içerir. Tüm anahtarlar bu limitleri paylaşır; yeni token limitleri sıfırlamaz. Plan değişikliği token süresi dolmadan uygulanabilir.
- read_per_minute
- Dakika başına okuma isteği.
- write_per_minute
- Dakika başına yazma isteği; bu değer yazma yetkisi vermez.
- auth_per_minute
- Başarısız kimlik doğrulama denemeleri dahil, dakika başına token isteği.