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, lietotājvārdu un paroli;
- Izmantojot savu API atslēgu, lietotājvārdu un šifrētas paroles datus.
Izmantojot savu API atslēgu, lietotājvārdu un paroli
Šeit jums vienkārši jāizmanto POST /session galapunkts un jānorāda platformas Iestatījumu sadaļā saņemtā API atslēga X-CAP-API-KEY galvenes laukā, lietotājvārds un API atslēgas parole parametrā identifier un password. Parametra encryptedPassword vērtībai jābūt false.
Izmantojot savu API atslēgu, lietotājvārdu un šifrētas paroles datus
- Vispirms jāizmanto GET /session/encryptionKey un jānorāda platformas Iestatījumu sadaļā ģenerētā API atslēga X-CAP-API-KEY galvenes laukā. 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 galapunktu, iestatiet encryptedPassword parametra vērtību uz true un norādiet platformas Iestatījumu sadaļā saņemto API atslēgu X-CAP-API-KEY galvenes laukā, lietotājvārdu un iepriekš šifrēto API atslēgas paroles datus parametrā identifier un password.
Sākot sesiju, atbildes galvenēs saņemsiet CST un X-SECURITY-TOKEN parametrus. Šie abi tokeni jāizmanto katra sūtītā pieprasījuma galvenēs.