Ennen kuin aloitat API:n käytön, sinun tulee tunnistautua luodaksesi istunnon.
Tunnistautuminen:
Istunnon voi aloittaa kahdella tavalla:
- Käyttämällä API-avaintasi, kirjautumistietojasi ja salasanaasi;
- Käyttämällä API-avaintasi, kirjautumistietojasi ja salattua salasanaa.
Tässä sinun tulee yksinkertaisesti käyttää POST /session -päätepistettä ja mainita alustan Asetukset-kohdasta saamasi API-avain X-CAP-API-KEY-otsikossa, sekä kirjautumis- ja API-avaimen salasanatiedot identifier- ja password-parametreissa. encryptedPassword-parametrin arvon tulee olla false.
- Ensiksi sinun tulee käyttää GET /session/encryptionKey -päätepistettä ja mainita alustan Asetukset-kohdasta luotu API-avain X-CAP-API-KEY-otsikossa. Vastauksena saat encryptionKey- ja timeStamp-parametrit;
- Saatuja encryptionKey- ja timeStamp-parametreja käyttäen sinun tulee salata API-avaimen salasanasi AES-salausmenetelmällä.
- Siirry POST /session -päätepisteeseen, aseta encryptedPassword-parametrin arvoksi true ja mainitse alustan Asetukset-kohdasta saamasi API-avain X-CAP-API-KEY-otsikossa, sekä kirjautumis- ja aiemmin salattu API-avaimen salasanatieto identifier- ja password-parametreissa.
Istunnon aloituksen jälkeen saat CST- ja X-SECURITY-TOKEN-parametrit vasteen otsikoissa. Molempia näistä tunnisteista tulee käyttää jokaisen lähettämäsi pyynnön otsikoissa.