Tapatybės patvirtinimas
- Authorization: ApiKey
- API raktas siunčiamas tik POST /api/v1/auth/token užklausos Authorization antraštėje. Nedėkite jo į JSON, URL ar užklausos parametrus.
- Authorization: Bearer
- Grąžintą žetoną naudokite išteklių užklausoms ir atnaujinkite pagal expires_at; expires_in nurodomas sekundėmis.
Kodėl pirmiausia gauti prieigos žetoną?
API raktas naudojamas prieigos žetonui gauti. Žetonas galioja 15 minučių ir tinka kelioms užklausoms. Ištekliams siųskite tik žetoną antraštėje Authorization: Bearer.
Įprastose užklausose API rakto nėra. Nutekėjęs žetonas suteikia prieigą ne ilgiau nei iki jo galiojimo pabaigos. Pavogtas API raktas vis tiek gali leisti gauti naujų žetonų.
Kiek laiko galioja žetonas?
- expires_in
- 900 sekundžių, arba 15 minučių nuo išdavimo. Užklausos nepratęsia galiojimo.
- expires_at
- Galiojimo pabaigos laikas UTC. Dabartiniai prieigos apribojimai gali užblokuoti žetoną anksčiau.
Kada gauti naują žetoną?
Tą patį žetoną naudokite kelioms užklausoms ir naują gaukite prieš expires_at. Nereikia gauti žetono prieš kiekvieną operaciją. Naujam žetonui gauti naudokite API raktą.
Prieiga uždrausta ir pakartotiniai bandymai
- 401
- 401 ne visada reiškia pasibaigusį žetono galiojimą. Jei jis baigėsi, gaukite naują ir kartokite skaitymą daugiausia vieną kartą. Jei žetono gavimas grąžina 401, patikrinkite raktą ir sustabdykite automatinius bandymus.
- 403
- Gavę 403, patikrinkite teises, IP apribojimus ir planą. Naujas žetonas neatkuria atšauktos prieigos.
IP apribojimai
- Prieigos žetonas neapeina dabartinių rakto teisių, parduotuvės teisių, atšaukimo ar IP apribojimų.
- Jei reikia, apribokite raktą integracijos šaltinio adresais.
- Administratorius gali keisti šį sąrašą; priimami ne daugiau kaip 32 adresai.
Raktų valdymas
- API raktų valdymas yra atskiras nuo integracijos teisių į išteklius.
- Tik owner gali suteikti grupėms administravimo teises peržiūrėti, kurti, redaguoti ar šalinti raktus; įgaliotas grupės narys gali atlikti tik tai grupei leistus veiksmus.
Užklausų dažnio ribos
Engine ≥ 4.143.0. Kiekviename žetono atsakyme pateikiami išdavimo metu galiojančios parduotuvės politikos data.rate_limits. Visi raktai dalijasi šiais limitais; naujas žetonas jų neatkuria. Plano pakeitimas gali įsigalioti dar nepasibaigus žetonui.
- read_per_minute
- Skaitymo užklausos per minutę.
- write_per_minute
- Rašymo užklausos per minutę; ši reikšmė nesuteikia rašymo teisių.
- auth_per_minute
- Žetono užklausos per minutę, įskaitant nepavykusius autentifikavimo bandymus.