İçeriğe atla
ShopentlyLearn

Veri şemaları: Kimlik doğrulama

Veri şemaları: Kimlik doğrulama. API'nin kabul ettiği veya döndürdüğü verilerin alanları, türleri ve kısıtlamaları.

Veri şemaları

Getir · Erişim belirteci — Kimlik doğrulama — Yanıt

ApiResponse_TokenData_ · API'nin kabul ettiği veya döndürdüğü verilerin alanları, türleri ve kısıtlamaları.
dataTokenData Zorunlu

Yanıt örneği · TokenData.

Örnek: {"access_token":"EXAMPLE_ACCESS_TOKEN","expires_at":"2026-01-01T12:00:00Z","expires_in":900,"rate_limits":{"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10},"token_type":"Bearer"}
metaContextPageMeta ContextMeta PageMeta RequestMeta Zorunlu

Yanıt üst verileri.

Örnek: {"request_id":"example"}

Ek alanlar: Hayır

Getir · Erişim belirteci — Kimlik doğrulama — Yanıt

TokenData · API'nin kabul ettiği veya döndürdüğü verilerin alanları, türleri ve kısıtlamaları.
access_tokenDizeZorunlu

Authorization: Bearer başlığı için token. Ayrı örneği çalıştırmadan önce SHOPENTLY_ACCESS_TOKEN değişkenini ayarlayın.

Örnek: "EXAMPLE_ACCESS_TOKEN"
expires_atDizeZorunlu

UTC olarak sona erme zamanı. Geçerli erişim kısıtlamaları tokenı daha önce engelleyebilir.

format: "date-time"
Örnek: "2026-01-01T12:00:00Z"
expires_inTam sayıİsteğe bağlı

Düzenlendiği andan itibaren 900 saniye, yani 15 dakika. İstek göndermek geçerlilik süresini uzatmaz.

Varsayılan: 900Örnek: 900
rate_limitsTokenRateLimitsData Zorunlu

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.

Örnek: {"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10}
token_typeDizeİsteğe bağlı

Bearer. Döndürülen belirtecin kimlik doğrulama şeması.

const: "Bearer"
Varsayılan: "Bearer"Örnek: "Bearer"

Ek alanlar: Hayır

İstek hızı sınırları

TokenRateLimitsData · 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. Sıfır, sınırsız değil, kullanılamaz anlamına gelir.
auth_per_minuteTam sayıZorunlu

Başarısız kimlik doğrulama denemeleri dahil, dakika başına token isteği.

minimum: 0maximum: 1000000
Örnek: 10
read_per_minuteTam sayıZorunlu

Dakika başına okuma isteği.

minimum: 0maximum: 1000000
Örnek: 60
write_per_minuteTam sayıZorunlu

Dakika başına yazma isteği; bu değer yazma yetkisi vermez.

minimum: 0maximum: 1000000
Örnek: 10

Ek alanlar: Hayır

Getir · Erişim belirteci — Kimlik doğrulama — İstek gövdesi

TokenRequest · API'nin kabul ettiği veya döndürdüğü verilerin alanları, türleri ve kısıtlamaları.
NesneEk alanlar: Hayır

Ek alanlar: Hayır