Preverjanje pristnosti
- Authorization: ApiKey
- Ključ API pošljite izključno v glavi Authorization zahteve POST /api/v1/auth/token. Ne vključujte ga v JSON, URL ali parametre poizvedbe.
- Authorization: Bearer
- Vrnjeni žeton uporabite za zahteve za vire in ga obnovite glede na expires_at; expires_in je izražen v sekundah.
Zakaj najprej pridobiti žeton?
Ključ API uporabite za pridobitev žetona. Žeton velja 15 minut in ga lahko uporabite za več zahtev. Virom pošljite samo žeton v glavi Authorization: Bearer.
Običajne zahteve ne vsebujejo ključa API. Razkrit žeton omogoča dostop največ do izteka veljavnosti. Ukraden ključ API lahko še vedno omogoča pridobivanje novih žetonov.
Kako dolgo velja žeton?
- expires_in
- 900 sekund oziroma 15 minut od izdaje. Pošiljanje zahtev ne podaljša veljavnosti.
- expires_at
- Čas izteka v UTC. Trenutne omejitve dostopa lahko žeton blokirajo prej.
Kdaj pridobiti nov žeton?
Isti žeton uporabite za več zahtev in novega pridobite pred expires_at. Žetona ne pridobivajte pred vsako operacijo. Za nov žeton uporabite ključ API.
Zavrnjen dostop in ponovni poskusi
- 401
- 401 ne pomeni vedno, da je žeton potekel. Če je potekel, pridobite novega in branje ponovite največ enkrat. Če pridobivanje žetona vrne 401, preverite ključ in ustavite samodejne poskuse.
- 403
- Pri 403 preverite dovoljenja, omejitve IP in paket. Nov žeton ne povrne preklicanega dostopa.
Omejitve IP
- Žeton ne obide trenutnih dovoljenj ključa, upravičenj trgovine, preklica ali omejitev IP.
- Kadar je primerno, ključ omejite na izvorne naslove integracije.
- Skrbnik lahko ta seznam ureja; dovoljenih je največ 32 naslovov.
Upravljanje ključev
- Upravljanje ključev API je ločeno od dovoljenj integracije za vire.
- Samo owner lahko skupinam dodeli skrbniška dovoljenja za ogled, ustvarjanje, urejanje ali brisanje ključev; pooblaščeni član skupine lahko izvaja samo dejanja, dovoljena tej skupini.
Omejitve pogostosti zahtev
Engine ≥ 4.143.0. Vsak odgovor z žetonom vsebuje data.rate_limits iz pravil trgovine ob izdaji. Vsi ključi si delijo te omejitve; nov žeton jih ne ponastavi. Sprememba paketa lahko začne veljati pred potekom žetona.
- read_per_minute
- Zahteve za branje na minuto.
- write_per_minute
- Zahteve za pisanje na minuto; ta vrednost ne dodeli pravic pisanja.
- auth_per_minute
- Zahteve za žeton na minuto, vključno z neuspešnimi poskusi preverjanja pristnosti.