Enne API kasutamise alustamist peate autentima, et luua seanss.
Autentimine:
Seansi alustamiseks on 2 viisi:
- Kasutades oma API võtit, sisselogimis- ja parooliteavet;
- Kasutades oma API võtit, sisselogimis- ja krüpteeritud parooliteavet.
Siin peate lihtsalt kasutama POST /session lõpp-punkti ja märkima platvormi Seadetes saadud API võtme X-CAP-API-KEY päises, sisselogimis- ja API võtme parooli info identifier ja password parameetrites. encryptedPassword parameetri väärtus peab olema false.
- Kõigepealt peate kasutama GET /session/encryptionKey ja märkima platvormi Seadetes genereeritud API võtme X-CAP-API-KEY päises. Vastusena saate encryptionKey ja timeStamp parameetrid;
- Saadud encryptionKey ja timeStamp parameetreid kasutades peate oma API võtme parooli krüpteerima AES krüpteerimismeetodil.
- Minge POST /session lõpp-punkti, seadke encryptedPassword parameetrile väärtus true ja märkige platvormi Seadetes saadud API võti X-CAP-API-KEY päises, sisselogimis- ja eelnevalt krüpteeritud API võtme parooli info identifier ja password parameetrites
Seansi alustamisel saate vastuse päistes CST ja X-SECURITY-TOKEN parameetrid. Mõlemat neist tokenitest tuleb kasutada iga saadetava päringu päistes.