Przejdź do treści
ShopentlyLearn

Modele uwierzytelniania

Schematy klucza i tokena dostępu Shopently API. Sprawdź pola żądania uwierzytelnienia, odpowiedź tokena oraz typy danych.

Schematy danych

Pobierz token dostępu — Odpowiedź

ApiResponse_TokenData_ · Pola, typy i ograniczenia danych przyjmowanych lub zwracanych przez API.
dataTokenData Wymagane

Przykład odpowiedzi · TokenData.

Przykład: {"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 Wymagane

Metadane odpowiedzi.

Przykład: {"request_id":"example"}

Dodatkowe pola: Nie

Pobierz token dostępu — Odpowiedź

TokenData · Pola, typy i ograniczenia danych przyjmowanych lub zwracanych przez API.
access_tokenTekstWymagane

Token do nagłówka Authorization: Bearer. Przed osobnym przykładem ustaw go jako SHOPENTLY_ACCESS_TOKEN.

Przykład: "EXAMPLE_ACCESS_TOKEN"
expires_atTekstWymagane

Termin wygaśnięcia w UTC. Aktualne ograniczenia dostępu mogą zablokować token wcześniej.

format: "date-time"
Przykład: "2026-01-01T12:00:00Z"
expires_inLiczba całkowitaOpcjonalne

900 sekund, czyli 15 minut od wystawienia. Wykonywanie żądań nie przedłuża ważności.

Wartość domyślna: 900Przykład: 900
rate_limitsTokenRateLimitsData Wymagane

Engine ≥ 4.143.0. Każda odpowiedź z tokenem zawiera data.rate_limits z polityki sklepu obowiązującej przy jego wydaniu. Wszystkie klucze współdzielą te budżety; nowy token ich nie resetuje. Zmiana planu może obowiązywać przed wygaśnięciem tokenu.

Przykład: {"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10}
token_typeTekstOpcjonalne

Bearer. Schemat uwierzytelniania zwróconego tokenu.

const: "Bearer"
Wartość domyślna: "Bearer"Przykład: "Bearer"

Dodatkowe pola: Nie

Limity zapytań API

TokenRateLimitsData · Engine ≥ 4.143.0. Każda odpowiedź z tokenem zawiera data.rate_limits z polityki sklepu obowiązującej przy jego wydaniu. Wszystkie klucze współdzielą te budżety; nowy token ich nie resetuje. Zmiana planu może obowiązywać przed wygaśnięciem tokenu. Zero oznacza niedostępność, a nie brak ograniczenia.
auth_per_minuteLiczba całkowitaWymagane

Żądania pobrania tokenu na minutę, także nieudane próby uwierzytelnienia.

minimum: 0maximum: 1000000
Przykład: 10
read_per_minuteLiczba całkowitaWymagane

Zapytania odczytu na minutę.

minimum: 0maximum: 1000000
Przykład: 60
write_per_minuteLiczba całkowitaWymagane

Zapytania zapisu na minutę; ta wartość nie nadaje uprawnień do zapisu.

minimum: 0maximum: 1000000
Przykład: 10

Dodatkowe pola: Nie

Pobierz token dostępu — Treść żądania

TokenRequest · Pola, typy i ograniczenia danych przyjmowanych lub zwracanych przez API.
ObiektDodatkowe pola: Nie

Dodatkowe pola: Nie