Pereiti prie turinio
ShopentlyLearn

Duomenų schemos: Tapatybės patvirtinimas

Duomenų schemos: Tapatybės patvirtinimas. API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai.

Duomenų schemos

Gauti · Prieigos raktas — Tapatybės patvirtinimas — Atsakymas

ApiResponse_TokenData_ · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai.
dataTokenData Privalomas

Atsakymo pavyzdys · TokenData.

Pavyzdys: {"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 Privalomas

Atsakymo metaduomenys.

Pavyzdys: {"request_id":"example"}

Papildomi laukai: Ne

Gauti · Prieigos raktas — Tapatybės patvirtinimas — Atsakymas

TokenData · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai.
access_tokenEilutėPrivalomas

Žetonas antraštei Authorization: Bearer. Prieš vykdydami atskirą pavyzdį nustatykite SHOPENTLY_ACCESS_TOKEN.

Pavyzdys: "EXAMPLE_ACCESS_TOKEN"
expires_atEilutėPrivalomas

Galiojimo pabaigos laikas UTC. Dabartiniai prieigos apribojimai gali užblokuoti žetoną anksčiau.

format: "date-time"
Pavyzdys: "2026-01-01T12:00:00Z"
expires_inSveikasis skaičiusNeprivalomas

900 sekundžių, arba 15 minučių nuo išdavimo. Užklausos nepratęsia galiojimo.

Numatytoji reikšmė: 900Pavyzdys: 900
rate_limitsTokenRateLimitsData Privalomas

Engine ≥ 4.143.0. Kiekviename žetono atsakyme pateikiami išdavimo metu galiojančios parduotuvės politikos data.rate_limits. Visi raktai dalijasi šiais limitais; naujas žetonas jų neatkuria. Plano pakeitimas gali įsigalioti dar nepasibaigus žetonui.

Pavyzdys: {"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10}
token_typeEilutėNeprivalomas

Bearer. Grąžinto žetono tapatybės patvirtinimo schema.

const: "Bearer"
Numatytoji reikšmė: "Bearer"Pavyzdys: "Bearer"

Papildomi laukai: Ne

Užklausų dažnio ribos

TokenRateLimitsData · Engine ≥ 4.143.0. Kiekviename žetono atsakyme pateikiami išdavimo metu galiojančios parduotuvės politikos data.rate_limits. Visi raktai dalijasi šiais limitais; naujas žetonas jų neatkuria. Plano pakeitimas gali įsigalioti dar nepasibaigus žetonui. Nulis reiškia nepasiekiamumą, o ne neribotą naudojimą.
auth_per_minuteSveikasis skaičiusPrivalomas

Žetono užklausos per minutę, įskaitant nepavykusius autentifikavimo bandymus.

minimum: 0maximum: 1000000
Pavyzdys: 10
read_per_minuteSveikasis skaičiusPrivalomas

Skaitymo užklausos per minutę.

minimum: 0maximum: 1000000
Pavyzdys: 60
write_per_minuteSveikasis skaičiusPrivalomas

Rašymo užklausos per minutę; ši reikšmė nesuteikia rašymo teisių.

minimum: 0maximum: 1000000
Pavyzdys: 10

Papildomi laukai: Ne

Gauti · Prieigos raktas — Tapatybės patvirtinimas — Užklausos turinys

TokenRequest · API priimamų arba grąžinamų duomenų laukai, tipai ir apribojimai.
ObjektasPapildomi laukai: Ne

Papildomi laukai: Ne