Autentifikacija
- Authorization: ApiKey
- API ključ šalje se isključivo u zaglavlju Authorization zahtjeva POST /api/v1/auth/token. Ne stavljajte ga u JSON, URL ili parametre upita.
- Authorization: Bearer
- Dobiveni token koristite za zahtjeve prema resursima i obnavljajte ga prema expires_at; expires_in izražen je u sekundama.
Zašto prvo dohvatiti token?
API ključ služi za dohvat tokena. Token vrijedi 15 minuta i može se koristiti za više zahtjeva. Resursima šaljite samo token u zaglavlju Authorization: Bearer.
Uobičajeni zahtjevi ne sadrže API ključ. Procurjeli token omogućuje pristup najdulje do isteka valjanosti. Ukradeni API ključ i dalje može omogućiti dohvat novih tokena.
Koliko dugo token vrijedi?
- expires_in
- 900 sekundi, odnosno 15 minuta od izdavanja. Slanje zahtjeva ne produljuje valjanost.
- expires_at
- Vrijeme isteka u UTC-u. Trenutačna ograničenja pristupa mogu blokirati token ranije.
Kada dohvatiti novi token?
Koristite isti token za više zahtjeva i dohvatite novi prije expires_at. Ne dohvaćajte token prije svake operacije. Za novi token koristite API ključ.
Odbijen pristup i ponovni pokušaji
- 401
- 401 ne znači uvijek da je token istekao. Ako je istekao, dohvatite novi i ponovite čitanje najviše jednom. Ako dohvat tokena vrati 401, provjerite ključ i zaustavite automatske pokušaje.
- 403
- Za 403 provjerite ovlasti, IP ograničenja i plan. Novi token ne vraća opozvani pristup.
IP ograničenja
- Pristupni token ne zaobilazi trenutačne ovlasti ključa, prava trgovine, opoziv ni IP ograničenja.
- Prema potrebi ograničite ključ na izvorne adrese integracije.
- Administrator može urediti taj popis; dopuštene su najviše 32 adrese.
Upravljanje ključevima
- Upravljanje API ključevima odvojeno je od ovlasti integracije za resurse.
- Samo owner može grupama dodijeliti administrativne ovlasti za pregled, izradu, uređivanje ili brisanje ključeva; ovlašteni član grupe može obavljati samo radnje dodijeljene toj grupi.
Ograničenja učestalosti
Engine ≥ 4.143.0. Svaki odgovor s tokenom sadrži data.rate_limits iz pravila trgovine pri izdavanju. Svi ključevi dijele te limite; novi token ih ne obnavlja. Promjena plana može se primijeniti prije isteka tokena.
- read_per_minute
- Zahtjevi za čitanje u minuti.
- write_per_minute
- Zahtjevi za pisanje u minuti; ta vrijednost ne daje prava pisanja.
- auth_per_minute
- Zahtjevi za token u minuti, uključujući neuspjele pokušaje autentifikacije.