Ugrás a tartalomhoz
ShopentlyLearn

Adatsémák: Hitelesítés

Adatsémák: Hitelesítés. Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.

Adatsémák

Lekérés · Token — Hitelesítés — Válasz

ApiResponse_TokenData_ · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
dataTokenData Kötelező

Példaválasz · TokenData.

Példa: {"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 Kötelező

A válasz metaadatai.

Példa: {"request_id":"example"}

További mezők: Nem

Lekérés · Token — Hitelesítés — Válasz

TokenData · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
access_tokenKarakterláncKötelező

Token az Authorization: Bearer fejléchez. Az önálló példa futtatása előtt állítsa be a SHOPENTLY_ACCESS_TOKEN változót.

Példa: "EXAMPLE_ACCESS_TOKEN"
expires_atKarakterláncKötelező

A lejárat időpontja UTC szerint. Az aktuális hozzáférési korlátozások korábban is letilthatják a tokent.

format: "date-time"
Példa: "2026-01-01T12:00:00Z"
expires_inEgész számNem kötelező

A kiadástól számított 900 másodpercig, vagyis 15 percig. A kérések nem hosszabbítják meg az érvényességet.

Alapértelmezett: 900Példa: 900
rate_limitsTokenRateLimitsData Kötelező

Engine ≥ 4.143.0. Minden tokenválasz tartalmazza a kiadáskor érvényes áruházi szabályzat data.rate_limits értékeit. Az összes kulcs közösen használja ezeket a kereteket; új token nem állítja vissza őket. A csomagváltás a token lejárta előtt is érvényesülhet.

Példa: {"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10}
token_typeKarakterláncNem kötelező

Bearer. A visszaadott token hitelesítési sémája.

const: "Bearer"
Alapértelmezett: "Bearer"Példa: "Bearer"

További mezők: Nem

Kéréskorlátok

TokenRateLimitsData · Engine ≥ 4.143.0. Minden tokenválasz tartalmazza a kiadáskor érvényes áruházi szabályzat data.rate_limits értékeit. Az összes kulcs közösen használja ezeket a kereteket; új token nem állítja vissza őket. A csomagváltás a token lejárta előtt is érvényesülhet. A nulla nem elérhető műveletet jelent, nem korlátlan használatot.
auth_per_minuteEgész számKötelező

Tokenkérések percenként, a sikertelen hitelesítési kísérletekkel együtt.

minimum: 0maximum: 1000000
Példa: 10
read_per_minuteEgész számKötelező

Olvasási kérések percenként.

minimum: 0maximum: 1000000
Példa: 60
write_per_minuteEgész számKötelező

Írási kérések percenként; ez az érték nem ad írási jogosultságot.

minimum: 0maximum: 1000000
Példa: 10

További mezők: Nem

Lekérés · Token — Hitelesítés — Kérés törzse

TokenRequest · Az API által fogadott vagy visszaadott adatok mezői, típusai és korlátozásai.
ObjektumTovábbi mezők: Nem

További mezők: Nem