Enne API kasutamise alustamist peate autentima, et luua sessioon.
Autentimine:
Sessiooni alustamiseks on 2 võimalust:
- Kasutades oma API võtit, kasutajanime ja parooli andmeid;
- Kasutades oma API võtit, kasutajanime ja krüpteeritud parooli andmeid.
Kasutades oma API võtit, kasutajanime ja parooli andmeid
Siin tuleb lihtsalt kasutada POST /session lõpp-punkti ja märkida platvormi Seadete API võtmes saadud väärtus X-CAP-API-KEY päises, kasutajanimi ja API võtme parooli info identifier ja password parameetrites. Parameetri encryptedPassword väärtus peaks olema false.
Kasutades oma API võtit, kasutajanime ja krüpteeritud parooli andmeid
- Esmalt tuleb kasutada GET /session/encryptionKey ja märkida platvormi Seadete API võti X-CAP-API-KEY päises. Vastuseks saate encryptionKey ja timeStamp parameetrid;
- Saadud encryptionKey ja timeStamp parameetrite abil tuleb krüpteerida oma API võtme parool, kasutades AES krüpteerimismeetodit.
- Minge POST /session lõpp-punkti, seadke encryptedPassword parameetri väärtuseks true ning märkige platvormi Seadete API võtmes saadud väärtus X-CAP-API-KEY päises, kasutajanimi ja eelnevalt krüpteeritud API võtme parooli info identifier ja password parameetrites
Sessiooni alustamisel saate vastuse päistes CST ja X-SECURITY-TOKEN parameetrid. Mõlemat tokenit tuleb kasutada iga saadetava päringu päistes.