Autentificare
- Authorization: ApiKey
- Cheia API se trimite exclusiv în antetul Authorization al cererii POST /api/v1/auth/token. Nu o includeți în JSON, într-un URL sau în parametrii de interogare.
- Authorization: Bearer
- Folosiți tokenul primit pentru cererile către resurse și reînnoiți-l conform expires_at; expires_in este exprimat în secunde.
De ce obții mai întâi un token?
Cheia API este folosită pentru a obține un token. Tokenul este valabil 15 minute și poate fi folosit pentru mai multe cereri. Pentru resurse, trimite doar tokenul în antetul Authorization: Bearer.
Cererile obișnuite nu conțin cheia API. Un token divulgat permite accesul cel mult până la expirare. O cheie API furată poate permite în continuare obținerea de tokenuri noi.
Cât timp este valabil tokenul?
- expires_in
- 900 de secunde, adică 15 minute de la emitere. Trimiterea cererilor nu prelungește valabilitatea.
- expires_at
- Momentul expirării în UTC. Restricțiile de acces actuale pot bloca tokenul mai devreme.
Când obții un token nou?
Reutilizează tokenul pentru mai multe cereri și obține altul înainte de expires_at. Nu cere un token înaintea fiecărei operații. Folosește cheia API pentru a obține noul token.
Acces refuzat și reîncercări
- 401
- 401 nu înseamnă întotdeauna că tokenul a expirat. Dacă a expirat, obține unul nou și repetă citirea cel mult o dată. Dacă obținerea tokenului returnează 401, verifică cheia și oprește încercările automate.
- 403
- La 403, verifică permisiunile, restricțiile IP și planul. Un token nou nu restabilește accesul revocat.
Restricții IP
- Tokenul de acces nu ocolește permisiunile curente ale cheii, drepturile magazinului, revocarea sau restricțiile IP.
- Dacă este necesar, limitați cheia la adresele sursă ale integrării.
- Administratorul poate edita lista; sunt acceptate cel mult 32 de adrese.
Gestionarea cheilor
- Gestionarea cheilor API este separată de permisiunile integrării asupra resurselor.
- Numai owner poate acorda grupurilor permisiuni administrative pentru vizualizarea, crearea, editarea sau ștergerea cheilor; un membru autorizat poate efectua numai acțiunile acordate grupului său.
Limite de cereri
Engine ≥ 4.143.0. Fiecare răspuns cu token include data.rate_limits din politica magazinului la emitere. Toate cheile partajează aceste limite; un token nou nu le resetează. Schimbarea planului se poate aplica înainte de expirarea tokenului.
- read_per_minute
- Cereri de citire pe minut.
- write_per_minute
- Cereri de scriere pe minut; această valoare nu acordă drepturi de scriere.
- auth_per_minute
- Cereri de token pe minut, inclusiv încercările de autentificare eșuate.