Erişim tokenları ne işe yarar?
Erişim tokenları, harici uygulamaların (kendi komut dosyalarınız, entegrasyonlar, analiz araçları veya webhook işleyicileri) Storeep API'si aracılığıyla mağazanızdaki verileri okumasına olanak tanır. Her tokenın sınırlı bir izin seti ve isteğe bağlı bir son kullanma tarihi vardır. Tokenlar, hesap kimlik bilgilerinizi paylaşmaktan daha güvenlidir; zira yalnızca entegrasyonun ihtiyaç duyduğu kapsamla sınırlandırılabilir ve herhangi bir zamanda tek tek iptal edilebilir.
Tokenları yönetmek için Ayarlar → Erişim Tokenları bölümüne gidin. Paneldeki Belgeleri görüntüle düğmesi API referansına bağlantı verir.
Token sınırları
- Mağaza başına maksimum 40 erişim tokeni. Bu sınıra ulaşıldığında Yeni token oluştur düğmesi gizlenir.
- Tokenlar en yeniden en eskiye doğru listelenir, sayfa başına 20 adet.
Token oluşturma
Yeni token oluştur düğmesine tıklayın, formu doldurun ve Oluştur düğmesine tıklayın.
Token adı
- Zorunludur.
- Maksimum 50 karakter.
- Yalnızca token listesinde tanımlama için kullanılır. Üçüncü taraflara hiçbir zaman gönderilmez.
İzinler
Dört kullanılabilir izin kapsamından en az birini seçin. Her kapsam bağımsızdır:
- Ürünleri oku: ürün listelerine, ayrıntılarına, varyantlarına ve stok verilerine erişin.
- Siparişleri oku: sipariş geçmişine, ayrıntılarına, durumlarına ve satır öğelerine erişin.
- Webhook'ları oku: webhook yapılandırmalarını ve teslimat günlüklerini görüntüleyin.
- Webhook'ları yönet: webhook aboneliklerini oluşturun, güncelleyin ve silin.
En az bir kapsam seçmeniz gerekir. Seçilmeyen kapsamlar, API uç noktası mevcut olsa bile o token için erişilemez olur.
Veri erişimi
Bu ayar, tokenın verilerinize ne kadar geriye dönük erişebileceğini belirler. Entegrasyonunuzun ihtiyaçlarına uyan en kısıtlayıcı seçeneği tercih edin.
- Son 24 saat (varsayılan): token yalnızca son 24 saatteki verilere erişebilir. Canlı sipariş akışları gibi gerçek zamanlı entegrasyonlar için önerilir.
- Başlangıç tarihi belirle: token belirli bir takvim tarihinden itibaren verilere erişebilir. Seçildiğinde, başlangıç tarihini seçtiğiniz bir Veri erişimi başlangıç tarihi tarih seçici görünür.
- Tüm zamanlar: tarih kısıtlaması yok. Token tüm geçmiş verilere erişebilir. Yalnızca entegrasyonun gerçekten tam geçmişe ihtiyaç duyduğu durumlarda kullanın.
Son kullanma tarihi
- Sona ermez (varsayılan): token, manuel olarak silinene kadar süresiz olarak geçerlidir.
- Son kullanma tarihi belirle: seçildiğinde bir Son kullanma tarihi tarih seçici görünür. Tarih en az bir gün, en fazla bugünden itibaren bir yıl sonra olmalıdır. Son kullanma tarihinin ardından token otomatik olarak çalışmayı durdurur.
Token değeri
Oluştur düğmesine tıkladıktan sonra token değeri bir kez başarı mesajında gösterilir. Kopyalayın ve güvenli bir yerde saklayın. Storeep bunu bir daha gösteremez. Kaybederseniz tokeni silin ve yeni bir tane oluşturun.
Token düzenleme
Adını, izinlerini, veri erişim modunu ve son kullanma tarihini düzenlemek için bir token satırına tıklayın. Token değerini alamaz veya değiştiremezsiniz. Düzenleme yalnızca mevcut tokenla ilişkili ayarları değiştirir.
Token listesi sütunları
- Ad: tokene verdiğiniz etiket; altında oluşturulma tarihi.
- İzinler: verilen kapsamların listesi.
- Veri erişimi: moda bağlı olarak Son 24 saat, Tüm veriler veya [tarih]'ten itibaren gösterilir.
- Son kullanma: son kullanma tarihi veya Hiçbir zaman.
- Son kullanım: tokenın kimliği doğrulanmış bir API isteği yapmak için en son kullanıldığı tarih ve saat, ya da Hiçbir zaman.
Token silme
Bir veya daha fazla token seçin ve Tokenları sil düğmesine tıklayın. Silinen tokenlar hemen geçersiz kılınır. Silinen tokeni kullanan herhangi bir entegrasyon kimlik doğrulama hataları almaya başlar.
Güvenlik ipuçları
- Her entegrasyon için yalnızca gereken minimum izinleri verin.
- Webhook'lar ve gerçek zamanlı akışlar için Son 24 saat veri erişimi; zamanlanmış senkronizasyon işleri için Başlangıç tarihi belirle seçeneğini kullanın.
- Kısa süreli müteahhitlere veya tek seferlik entegrasyonlara verilen tokenlar için son kullanma tarihi belirleyin.
- Son kullanım sütununu izleyin. Hiç kullanılmamış veya yakın zamanda kullanılmamış bir token etkin olmayan bir entegrasyona ait olabilir; güvenle silinebilir.