Prieš pradėdami naudoti API, turėtumėte autentifikuotis ir sukurti sesiją.
Autentifikacija:
Yra 2 būdai pradėti sesiją:
- Naudojant savo API raktą, prisijungimo ir slaptažodžio duomenis;
- Naudojant savo API raktą, prisijungimo ir užšifruoto slaptažodžio duomenis.
Čia turėtumėte paprasčiausiai naudoti POST /session galinį tašką ir nurodyti platformos Nustatymuose gautą API raktą X-CAP-API-KEY antraštėje, prisijungimo vardą ir API rakto slaptažodį identifier ir password parametruose. encryptedPassword parametro reikšmė turi būti false.
- Visų pirma turėtumėte naudoti GET /session/encryptionKey ir nurodyti platformos Nustatymuose sugeneruotą API raktą X-CAP-API-KEY antraštėje. Atsakyme gausite encryptionKey ir timeStamp parametrus;
- Naudodami gautus encryptionKey ir timeStamp parametrus turėtumėte užšifruoti savo API rakto slaptažodį naudodami AES šifravimo metodą.
- Eikite į POST /session galinį tašką, encryptedPassword parametrui nustatykite true reikšmę ir nurodykite platformos Nustatymuose gautą API raktą X-CAP-API-KEY antraštėje, prisijungimo vardą ir anksčiau užšifruotą API rakto slaptažodį identifier ir password parametruose
Pradėjus sesiją, atsakymo antraštėse gausite CST ir X-SECURITY-TOKEN parametrus. Abu šie raktai turi būti naudojami kiekvienos siunčiamos užklausos antraštėse.