Erişim belirteçleri ne işe yarar
Erişim belirteçleri, kendi betiklerinizin ve üçüncü taraf entegrasyonlarınızın mağazanız adına Storeep API ile iletişim kurmasını sağlar. Her belirteç sabit bir izin kümesi, isteğe bağlı bir veri penceresi ve isteğe bağlı bir son kullanma tarihi taşır. Belirteçler, pano oturum bilginizi paylaşmaktan daha güvenlidir çünkü her birini bir entegrasyonun tam olarak ihtiyaç duyduğu şeyle kapsamlandırır ve istediğiniz zaman kendi başına iptal edersiniz.
Belirteçleri yönetmek için Ayarlar, Erişim belirteçleri bölümüne gidin. Belgeleri görüntüle düğmesi, tam API referansını yeni bir sekmede açar.
Belirteç sınırları
- Mağaza başına en fazla 40 erişim belirteci tutabilirsiniz. 40'a ulaştığınızda, birini silene kadar Yeni belirteç oluştur düğmesi kaybolur.
- Belirteçler en yeniden eskiye doğru, sayfa başına 20 tane listelenir.
Belirteç oluşturma
Yeni belirteç oluştur öğesine tıklayın, formu doldurun, ardından Oluştur öğesine tıklayın.
Belirteç adı
- Zorunlu, en fazla 50 karakter.
- Yalnızca belirteci listenizde tanımlamak için kullanılır. Asla üçüncü taraflara gönderilmez.
İzinler
Dört kapsamdan en az birini seçin. Her biri bağımsızdır ve API, vermediğiniz herhangi bir kapsama sahip isteği reddeder (ihtiyaç duyduğu kapsamı belirten bir 403 "yetersiz izinler" yanıtı):
- Ü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.
- Web kancalarını oku: web kancası yapılandırmalarınızı listeleyin ve görüntüleyin.
- Web kancalarını yönet: web kancaları oluşturun, güncelleyin ve silin.
Hiçbir şey seçmezseniz, oluşturma "Lütfen en az bir izin seçin" hatasıyla başarısız olur. Web kancalarının kendisi Ayarlar, Web kancaları altında kurulur; bu kapsamlar yalnızca onlara API erişimini kontrol eder.
Veri erişimi
Bu, belirtecin verilerinizi zamanda ne kadar geriye doğru okuyabileceğini kontrol eder. Yine de işe yarayan en kısıtlayıcı seçeneği seçin.
- Son 24 saat (varsayılan): belirteç yalnızca her istekte yeniden hesaplanan, sürekli kayan 24 saatlik bir pencereden gelen verileri görür. En güvenli, gerçek zamanlı akışlar için idealdir.
- Başlangıç tarihi belirle: belirteç yalnızca seçtiğiniz bir takvim tarihinde veya sonrasında oluşturulan verileri görür. Bunu seçmek bir Veri erişimi başlangıç tarihi seçicisini ortaya çıkarır.
- Tüm zamanlar: tarih kısıtlaması yok, belirteç tüm geçmişi okur. Yalnızca bir entegrasyonun buna gerçekten ihtiyacı olduğunda kullanın.
Son kullanma
- Asla sona ermez (varsayılan): silene kadar geçerli.
- Son kullanma tarihi belirle: bir Son kullanma tarihi seçicisini ortaya çıkarır. Tarih en az bir gün ileride ve bugünden itibaren en fazla bir yıl olmalıdır. Geçtikten sonra, belirteç otomatik olarak çalışmayı durdurur ve herhangi bir API çağrısı "erişim belirtecinin süresi doldu" döndürür.
Belirteç değeri (bir kez gösterilir)
Oluştur öğesine tıkladıktan sonra, belirteç değeri (bir UUID) başarı mesajında bir kez görünür. Onu hemen kopyalayın ve güvenli bir yerde saklayın. Storeep onu bir daha asla göstermez ve kurtaramaz. Kaybederseniz, belirteci silin ve yenisini oluşturun.
API ile bir belirteç kullanma
- Değeri bir HTTP başlığında Authorization: Bearer YOUR_TOKEN olarak gönderin. Eksik veya hatalı biçimlendirilmiş bir başlık bir 401 hatası döndürür.
- Her belirteç 60 saniyede 60 istek ile hız sınırlamasına tabidir. Bunu aşmak bir 429 "hız sınırı aşıldı" yanıtı döndürür, bu yüzden geri çekilin ve pencere sıfırlandıktan sonra yeniden deneyin.
- Liste uç noktaları bir market filtresini (bir ülke kodu veya en fazla 20), ayrıca limit (1 ile 50, varsayılan 20), page (varsayılan 1) ve created_at veya updated_at ile sıralamayı kabul eder. Uç nokta URL'leri ve tam ayrıntılar için Belgeleri görüntüle'ye bakın.
Bir belirteci düzenleme
Adını, izinlerini, veri erişim modunu ve son kullanma süresini düzenlemek için herhangi bir belirteç satırına tıklayın. Belirteç değerinin kendisini görüntüleyemez veya değiştiremezsiniz, düzenleme yalnızca mevcut belirtece eklenen ayarları günceller, böylece entegrasyonlar yeni bir değer olmadan çalışmaya devam eder.
Belirteçler listesi sütunları
- Ad: ona verdiğiniz etiket, altında oluşturma tarihi ve saati ile.
- İzinler: verilen kapsamlar (veya Yok).
- Veri erişimi: Son 24 saat, Tüm veriler veya [tarih] tarihinden itibaren gösterir.
- Son kullanma: son kullanma tarihi veya Asla.
- Son kullanım: belirtecin son kimlik doğrulamalı API çağrısının tarihi ve saati veya Asla.
Bir belirteci silme
Bir veya daha fazla belirteç seçin ve Belirteçleri sil öğesine tıklayın veya satır başına silme eylemini kullanın. Silme işlemi anında ve kesindir: o değeri hâlâ kullanan herhangi bir entegrasyon hemen 401 kimlik doğrulama hataları almaya başlar.
Güvenlik ipuçları
- Yalnızca bir entegrasyonun gerçekten ihtiyaç duyduğu kapsamları verin.
- Canlı akışlar için Son 24 saat veri erişimini koruyun ve zamanlanmış senkronizasyonlar için Başlangıç tarihi belirle'yi kullanın.
- Kısa süreli yükleniciler veya tek seferlik işler için bir son kullanma tarihi belirleyin.
- Son kullanım sütununu izleyin: Asla kullanılmayan veya uzun süre boşta kalan bir belirteç muhtemelen ölü bir entegrasyona aittir ve silinmesi güvenlidir.