Ennen API:n käyttöä sinun tulee todentaa itsesi luodaksesi istunnon.
Todennus:
Istunnon aloittamiseen on kaksi tapaa:
- Käyttämällä API-avaintasi, kirjautumistietojasi ja salasanaasi;
- Käyttämällä API-avaintasi, kirjautumistietojasi ja salattua salasanaasi.
Käyttämällä API-avaintasi, kirjautumistietojasi ja salasanaasi
Tässä sinun tulee yksinkertaisesti käyttää POST /session -päätepistettä ja mainita alustan asetuksissa vastaanotettu API-avain X-CAP-API-KEY-otsikossa, kirjautumistunnus ja API-avaimen salasana identifier- ja password-parametreissa. encryptedPassword-parametrin arvon tulee olla false.
Käyttämällä API-avaintasi, kirjautumistietojasi ja salattua salasanaasi
- Ensiksi sinun tulee käyttää GET /session/encryptionKey -päätepistettä ja mainita alustan asetuksissa luotu API-avain X-CAP-API-KEY-otsikossa. Vastauksena saat encryptionKey- ja timeStamp-parametrit;
- Saatujen encryptionKey- ja timeStamp-parametrien avulla sinun tulee salata API-avaimesi salasana AES-salausmenetelmällä.
- Siirry POST /session -päätepisteeseen, aseta encryptedPassword-parametrin arvoksi true ja mainitse alustan asetuksissa vastaanotettu API-avain X-CAP-API-KEY-otsikossa, kirjautumistunnus sekä aiemmin salattu API-avaimen salasana identifier- ja password-parametreissa
Istunnon aloittamisen jälkeen saat CST- ja X-SECURITY-TOKEN-parametrit vastausotsikoissa. Näitä molempia tunnuksia tulee käyttää jokaisen lähettämäsi pyynnön otsikoissa.