Skemi tad-data: Awtentikazzjoni

Skemi tad-data: Awtentikazzjoni. L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna.

Skemi tad-data

Ikseb · Token — Awtentikazzjoni — Risposta

ApiResponse_TokenData_ · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna.

dataTokenData Obbligatorju: Eżempju ta’ tweġiba · TokenData.

Eżempju: {"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 Obbligatorju: Metadata tat-tweġiba.

Eżempju: {"request_id":"example"}

Oqsma addizzjonali: Le

Ikseb · Token — Awtentikazzjoni — Risposta

TokenData · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna.

access_tokenStringObbligatorju: Token għall-intestatura Authorization: Bearer. Issettja SHOPENTLY_ACCESS_TOKEN qabel tħaddem l-eżempju separat.

Eżempju: "EXAMPLE_ACCESS_TOKEN"
expires_atStringObbligatorju: Il-ħin tal-iskadenza f’UTC. Ir-restrizzjonijiet attwali tal-aċċess jistgħu jimblukkaw it-token qabel.

format: "date-time"

Eżempju: "2026-01-01T12:00:00Z"
expires_inNumru sħiħMhux obbligatorju: 900 sekonda, jiġifieri 15-il minuta mill-ħruġ. It-talbiet ma jestendux il-validità.

Valur predefinit: 900Eżempju: 900
rate_limitsTokenRateLimitsData Obbligatorju: Engine ≥ 4.143.0. Kull tweġiba tat-token tinkludi data.rate_limits mill-politika tal-ħanut fil-ħin tal-ħruġ. Iċ-ċwievet kollha jaqsmu dawn il-limiti; token ġdid ma jerġax jibdihom. Bidla fil-pjan tista’ tapplika qabel jiskadi t-token.

Eżempju: {"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10}
token_typeStringMhux obbligatorju: Bearer. Skema tal-awtentikazzjoni għat-token mogħti.

const: "Bearer"

Valur predefinit: "Bearer"Eżempju: "Bearer"

Oqsma addizzjonali: Le

Limiti tar-rata

TokenRateLimitsData · Engine ≥ 4.143.0. Kull tweġiba tat-token tinkludi data.rate_limits mill-politika tal-ħanut fil-ħin tal-ħruġ. Iċ-ċwievet kollha jaqsmu dawn il-limiti; token ġdid ma jerġax jibdihom. Bidla fil-pjan tista’ tapplika qabel jiskadi t-token. Żero jfisser mhux disponibbli, mhux bla limitu.

auth_per_minuteNumru sħiħObbligatorju: Talbiet għal token kull minuta, inklużi tentattivi ta’ awtentikazzjoni li fallew.

minimum: 0maximum: 1000000

Eżempju: 10
read_per_minuteNumru sħiħObbligatorju: Talbiet għall-qari kull minuta.

minimum: 0maximum: 1000000

Eżempju: 60
write_per_minuteNumru sħiħObbligatorju: Talbiet għall-kitba kull minuta; dan il-valur ma jagħtix permessi għall-kitba.

minimum: 0maximum: 1000000

Eżempju: 10

Oqsma addizzjonali: Le

Ikseb · Token — Awtentikazzjoni — Kontenut tat-talba

TokenRequest · L-oqsma, it-tipi u r-restrizzjonijiet tad-data li l-API taċċetta jew tirritorna.

OġġettOqsma addizzjonali: Le

Oqsma addizzjonali: Le