Prieš pradėdami naudoti API, turite autentifikuotis, kad sukurtumėte sesiją.
Autentifikacija:
Yra 2 būdai pradėti sesiją:
- Naudojant savo API raktą, prisijungimo vardą ir slaptažodį;
- Naudojant savo API raktą, prisijungimo vardą ir užšifruotą slaptažodį.
Naudojant savo API raktą, prisijungimo vardą ir slaptažodį
Tiesiog turite 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žio informaciją identifier ir password parametruose. encryptedPassword parametro reikšmė turėtų būti false.
Naudojant savo API raktą, prisijungimo vardą ir užšifruotą slaptažodį
- Pirmiausia turite 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 turite užšifruoti savo API rakto slaptažodį naudodami AES šifravimo metodą.
- Eikite į POST /session galinį tašką, nustatykite encryptedPassword parametro reikšmę į true 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žio informaciją identifier ir password parametruose
Pradėjus sesiją, atsakymo antraštėse gausite CST ir X-SECURITY-TOKEN parametrus. Abu šie žetonai turi būti naudojami kiekvieno siunčiamo užklausos antraštėse.