Preskoči na vsebino
ShopentlyLearn

Podatkovne sheme: Preverjanje pristnosti

Podatkovne sheme: Preverjanje pristnosti. Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.

Podatkovne sheme

Pridobi · Žeton — Preverjanje pristnosti — Odgovor

ApiResponse_TokenData_ · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.
dataTokenData Obvezno

Primer odgovora · TokenData.

Primer: {"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 Obvezno

Metapodatki odgovora.

Primer: {"request_id":"example"}

Dodatna polja: Ne

Pridobi · Žeton — Preverjanje pristnosti — Odgovor

TokenData · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.
access_tokenNizObvezno

Žeton za glavo Authorization: Bearer. Pred zagonom ločenega primera nastavite SHOPENTLY_ACCESS_TOKEN.

Primer: "EXAMPLE_ACCESS_TOKEN"
expires_atNizObvezno

Čas izteka v UTC. Trenutne omejitve dostopa lahko žeton blokirajo prej.

format: "date-time"
Primer: "2026-01-01T12:00:00Z"
expires_inCelo številoIzbirno

900 sekund oziroma 15 minut od izdaje. Pošiljanje zahtev ne podaljša veljavnosti.

Privzeto: 900Primer: 900
rate_limitsTokenRateLimitsData Obvezno

Engine ≥ 4.143.0. Vsak odgovor z žetonom vsebuje data.rate_limits iz pravil trgovine ob izdaji. Vsi ključi si delijo te omejitve; nov žeton jih ne ponastavi. Sprememba paketa lahko začne veljati pred potekom žetona.

Primer: {"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10}
token_typeNizIzbirno

Bearer. Shema preverjanja pristnosti vrnjenega žetona.

const: "Bearer"
Privzeto: "Bearer"Primer: "Bearer"

Dodatna polja: Ne

Omejitve pogostosti zahtev

TokenRateLimitsData · Engine ≥ 4.143.0. Vsak odgovor z žetonom vsebuje data.rate_limits iz pravil trgovine ob izdaji. Vsi ključi si delijo te omejitve; nov žeton jih ne ponastavi. Sprememba paketa lahko začne veljati pred potekom žetona. Nič pomeni nedostopnost, ne neomejene uporabe.
auth_per_minuteCelo številoObvezno

Zahteve za žeton na minuto, vključno z neuspešnimi poskusi preverjanja pristnosti.

minimum: 0maximum: 1000000
Primer: 10
read_per_minuteCelo številoObvezno

Zahteve za branje na minuto.

minimum: 0maximum: 1000000
Primer: 60
write_per_minuteCelo številoObvezno

Zahteve za pisanje na minuto; ta vrednost ne dodeli pravic pisanja.

minimum: 0maximum: 1000000
Primer: 10

Dodatna polja: Ne

Pridobi · Žeton — Preverjanje pristnosti — Telo zahteve

TokenRequest · Polja, vrste in omejitve podatkov, ki jih API sprejema ali vrača.
ObjektDodatna polja: Ne

Dodatna polja: Ne