Autentifikacija
- Authorization: ApiKey
- API ključ šalje se isključivo u zaglavlju Authorization zahteva POST /api/v1/auth/token. Ne stavljajte ga u JSON, URL ili parametre upita.
- Authorization: Bearer
- Dobijeni token koristite za zahteve prema resursima i obnavljajte ga prema expires_at; expires_in izražen je u sekundama.
Zašto prvo preuzeti token?
API ključ služi za preuzimanje tokena. Token važi 15 minuta i može se koristiti za više zahteva. Resursima šaljite samo token u zaglavlju Authorization: Bearer.
Uobičajeni zahtevi ne sadrže API ključ. Procureli token omogućava pristup najduže do isteka važenja. Ukradeni API ključ i dalje može omogućiti preuzimanje novih tokena.
Koliko dugo token važi?
- expires_in
- 900 sekundi, odnosno 15 minuta od izdavanja. Slanje zahteva ne produžava važenje.
- expires_at
- Vreme isteka u UTC-u. Trenutna ograničenja pristupa mogu blokirati token ranije.
Kada preuzeti novi token?
Koristite isti token za više zahteva i preuzmite novi pre expires_at. Ne preuzimajte token pre svake operacije. Za novi token koristite API ključ.
Odbijen pristup i ponovni pokušaji
- 401
- 401 ne znači uvek da je token istekao. Ako je istekao, preuzmite novi i ponovite čitanje najviše jednom. Ako preuzimanje tokena vrati 401, proverite ključ i zaustavite automatske pokušaje.
- 403
- Za 403 proverite dozvole, IP ograničenja i plan. Novi token ne vraća opozvani pristup.
IP ograničenja
- Pristupni token ne zaobilazi trenutna ovlašćenja ključa, prava prodavnice, opoziv ni IP ograničenja.
- Prema potrebi ograničite ključ na izvorne adrese integracije.
- Administrator može urediti taj spisak; dozvoljene su najviše 32 adrese.
Upravljanje ključevima
- Upravljanje API ključevima odvojeno je od ovlašćenja integracije za resurse.
- Samo owner može grupama dodeliti administrativna ovlašćenja za pregled, kreiranje, uređivanje ili brisanje ključeva; ovlašćeni član grupe može obavljati samo radnje dodeljene toj grupi.
Ograničenja učestalosti
Engine ≥ 4.143.0. Svaki odgovor sa tokenom sadrži data.rate_limits iz pravila prodavnice u trenutku izdavanja. Svi ključevi dele ove limite; novi token ih ne resetuje. Promena plana može važiti pre isteka tokena.
- read_per_minute
- Zahtevi za čitanje u minutu.
- write_per_minute
- Zahtevi za upis u minutu; ova vrednost ne daje prava upisa.
- auth_per_minute
- Zahtevi za token u minutu, uključujući neuspele pokušaje autentifikacije.