Pirms sākt izmantot API, jums jāautentificējas, lai izveidotu sesiju.
Autentifikācija:
Ir 2 veidi, kā sākt sesiju:
- Izmantojot savu API atslēgu, pieteikšanās vārdu un paroli;
- Izmantojot savu API atslēgu, pieteikšanās vārdu un šifrētas paroles datus.
Šeit jums vienkārši jāizmanto POST /session gals un jānorāda platformas Iestatījumos saņemtā API atslēga X-CAP-API-KEY galvenē, pieteikšanās vārds un API atslēgas paroles informācija identifier un password parametros. encryptedPassword parametra vērtībai jābūt false.
- Vispirms jums jāizmanto GET /session/encryptionKey un jānorāda platformas Iestatījumos ģenerētā API atslēga X-CAP-API-KEY galvenē. Atbildē jūs saņemsiet encryptionKey un timeStamp parametrus;
- Izmantojot saņemtos encryptionKey un timeStamp parametrus, jums jāšifrē sava API atslēgas parole, izmantojot AES šifrēšanas metodi.
- Dodieties uz POST /session galu, iestatiet encryptedPassword parametram true vērtību un norādiet platformas Iestatījumos saņemto API atslēgu X-CAP-API-KEY galvenē, pieteikšanās vārdu un iepriekš šifrētās API atslēgas paroles informāciju identifier un password parametros
Uzsākot sesiju, jūs saņemsiet CST un X-SECURITY-TOKEN parametrus atbildes galvenēs. Abi šie tokeni ir jāizmanto katra pieprasījuma galvenēs, ko jūs sūtāt.