Overovanie
- Authorization: ApiKey
- Kľúč API sa posiela výhradne v hlavičke Authorization požiadavky POST /api/v1/auth/token. Nevkladajte ho do JSON, adresy URL ani parametrov dopytu.
- Authorization: Bearer
- Pri požiadavkách na zdroje používajte vrátený token a obnovujte ho podľa expires_at; expires_in sa uvádza v sekundách.
Prečo najprv získať token?
Kľúč API slúži na získanie tokenu. Token platí 15 minút a môžete ho použiť na viacero požiadaviek. K prostriedkom posielajte iba token v hlavičke Authorization: Bearer.
Bežné požiadavky neobsahujú kľúč API. Uniknutý token umožní prístup najdlhšie do konca svojej platnosti. Ukradnutý kľúč API však môže umožniť získavanie ďalších tokenov.
Ako dlho token platí?
- expires_in
- 900 sekúnd, teda 15 minút od vydania. Odosielanie požiadaviek platnosť nepredlžuje.
- expires_at
- Okamih vypršania v UTC. Aktuálne obmedzenia prístupu môžu token zablokovať skôr.
Kedy získať ďalší token?
Používajte rovnaký token na viacero požiadaviek a nový získajte pred expires_at. Token netreba získavať pred každou operáciou. Na získanie nového tokenu použite kľúč API.
Odmietnutý prístup a opakovanie
- 401
- 401 neznamená vždy vypršanie tokenu. Ak vypršal, získajte nový a čítanie zopakujte najviac raz. Ak získanie tokenu vráti 401, skontrolujte kľúč a zastavte automatické pokusy.
- 403
- Pri 403 skontrolujte oprávnenia, obmedzenia IP a plán. Nový token neobnoví odobratý prístup.
Obmedzenia IP
- Prístupový token neobchádza aktuálne oprávnenia kľúča, oprávnenia obchodu, odvolanie prístupu ani obmedzenia IP adries.
- Podľa potreby obmedzte kľúč na zdrojové adresy integrácie.
- Správca môže tento zoznam upravovať; prijíma sa najviac 32 adries.
Správa kľúčov
- Správa kľúčov API je oddelená od oprávnení integrácie k jednotlivým zdrojom.
- Iba owner môže skupinám udeliť oprávnenia na zobrazenie, vytváranie, úpravu alebo mazanie kľúčov; oprávnený člen skupiny smie vykonávať len akcie povolené tejto skupine.
Limity požiadaviek
Engine ≥ 4.143.0. Každá odpoveď s tokenom obsahuje data.rate_limits z pravidiel obchodu platných pri vydaní. Všetky kľúče zdieľajú tieto limity; nový token ich neobnovuje. Zmena programu môže platiť pred vypršaním tokenu.
- read_per_minute
- Požiadavky na čítanie za minútu.
- write_per_minute
- Požiadavky na zápis za minútu; táto hodnota neudeľuje právo zápisu.
- auth_per_minute
- Požiadavky na token za minútu vrátane neúspešných pokusov o overenie.