Treci la conținut
ShopentlyLearn

Scheme de date: Autentificare

Scheme de date: Autentificare. Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.

Scheme de date

Obține · Token — Autentificare — Răspuns

ApiResponse_TokenData_ · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.
dataTokenData Obligatoriu

Exemplu de răspuns · TokenData.

Exemplu: {"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 Obligatoriu

Metadatele răspunsului.

Exemplu: {"request_id":"example"}

Câmpuri suplimentare: Nu

Obține · Token — Autentificare — Răspuns

TokenData · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.
access_tokenȘir de caractereObligatoriu

Token pentru antetul Authorization: Bearer. Setează SHOPENTLY_ACCESS_TOKEN înainte de a rula exemplul separat.

Exemplu: "EXAMPLE_ACCESS_TOKEN"
expires_atȘir de caractereObligatoriu

Momentul expirării în UTC. Restricțiile de acces actuale pot bloca tokenul mai devreme.

format: "date-time"
Exemplu: "2026-01-01T12:00:00Z"
expires_inNumăr întregOpțional

900 de secunde, adică 15 minute de la emitere. Trimiterea cererilor nu prelungește valabilitatea.

Valoare implicită: 900Exemplu: 900
rate_limitsTokenRateLimitsData Obligatoriu

Engine ≥ 4.143.0. Fiecare răspuns cu token include data.rate_limits din politica magazinului la emitere. Toate cheile partajează aceste limite; un token nou nu le resetează. Schimbarea planului se poate aplica înainte de expirarea tokenului.

Exemplu: {"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10}
token_typeȘir de caractereOpțional

Bearer. Schema de autentificare pentru tokenul returnat.

const: "Bearer"
Valoare implicită: "Bearer"Exemplu: "Bearer"

Câmpuri suplimentare: Nu

Limite de cereri

TokenRateLimitsData · Engine ≥ 4.143.0. Fiecare răspuns cu token include data.rate_limits din politica magazinului la emitere. Toate cheile partajează aceste limite; un token nou nu le resetează. Schimbarea planului se poate aplica înainte de expirarea tokenului. Zero înseamnă indisponibil, nu nelimitat.
auth_per_minuteNumăr întregObligatoriu

Cereri de token pe minut, inclusiv încercările de autentificare eșuate.

minimum: 0maximum: 1000000
Exemplu: 10
read_per_minuteNumăr întregObligatoriu

Cereri de citire pe minut.

minimum: 0maximum: 1000000
Exemplu: 60
write_per_minuteNumăr întregObligatoriu

Cereri de scriere pe minut; această valoare nu acordă drepturi de scriere.

minimum: 0maximum: 1000000
Exemplu: 10

Câmpuri suplimentare: Nu

Obține · Token — Autentificare — Corpul cererii

TokenRequest · Câmpurile, tipurile și restricțiile datelor acceptate sau returnate de API.
ObiectCâmpuri suplimentare: Nu

Câmpuri suplimentare: Nu