Vai al contenuto
ShopentlyLearn

Schemi dei dati: Autenticazione

Schemi dei dati: Autenticazione. Campi, tipi e vincoli dei dati accettati o restituiti dall’API.

Schemi dei dati

Recupera · Token — Autenticazione — Risposta

ApiResponse_TokenData_ · Campi, tipi e vincoli dei dati accettati o restituiti dall’API.
dataTokenData Obbligatorio

Esempio di risposta · TokenData.

Esempio: {"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 Obbligatorio

Metadati della risposta.

Esempio: {"request_id":"example"}

Campi aggiuntivi: No

Recupera · Token — Autenticazione — Risposta

TokenData · Campi, tipi e vincoli dei dati accettati o restituiti dall’API.
access_tokenStringaObbligatorio

Token per l’header Authorization: Bearer. Imposta SHOPENTLY_ACCESS_TOKEN prima di eseguire l’esempio separato.

Esempio: "EXAMPLE_ACCESS_TOKEN"
expires_atStringaObbligatorio

Data e ora di scadenza in UTC. Le restrizioni di accesso attuali possono bloccare il token prima.

format: "date-time"
Esempio: "2026-01-01T12:00:00Z"
expires_inInteroFacoltativo

900 secondi, cioè 15 minuti dall’emissione. Le richieste non ne prolungano la validità.

Valore predefinito: 900Esempio: 900
rate_limitsTokenRateLimitsData Obbligatorio

Engine ≥ 4.143.0. Ogni risposta del token include data.rate_limits dalla politica del negozio al momento dell’emissione. Tutte le chiavi condividono questi limiti; un nuovo token non li azzera. Un cambio di piano può applicarsi prima della scadenza del token.

Esempio: {"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10}
token_typeStringaFacoltativo

Bearer. Schema di autenticazione del token restituito.

const: "Bearer"
Valore predefinito: "Bearer"Esempio: "Bearer"

Campi aggiuntivi: No

Limiti di frequenza

TokenRateLimitsData · Engine ≥ 4.143.0. Ogni risposta del token include data.rate_limits dalla politica del negozio al momento dell’emissione. Tutte le chiavi condividono questi limiti; un nuovo token non li azzera. Un cambio di piano può applicarsi prima della scadenza del token. Zero significa non disponibile, non illimitato.
auth_per_minuteInteroObbligatorio

Richieste di token al minuto, inclusi i tentativi di autenticazione non riusciti.

minimum: 0maximum: 1000000
Esempio: 10
read_per_minuteInteroObbligatorio

Richieste di lettura al minuto.

minimum: 0maximum: 1000000
Esempio: 60
write_per_minuteInteroObbligatorio

Richieste di scrittura al minuto; questo valore non concede permessi di scrittura.

minimum: 0maximum: 1000000
Esempio: 10

Campi aggiuntivi: No

Recupera · Token — Autenticazione — Corpo della richiesta

TokenRequest · Campi, tipi e vincoli dei dati accettati o restituiti dall’API.
OggettoCampi aggiuntivi: No

Campi aggiuntivi: No