Înainte de a începe să utilizați API-ul, trebuie să vă autentificați pentru a crea o sesiune.
Autentificare:
Există 2 modalități de a începe sesiunea:
- Folosind cheia API, numele de utilizator și parola;
- Folosind cheia API, numele de utilizator și parola criptată.
Folosind cheia API, numele de utilizator și parola
Aici trebuie pur și simplu să utilizați endpoint-ul POST /session și să menționați cheia API primită în Setările platformei în antetul X-CAP-API-KEY, precum și informațiile despre numele de utilizator și parola cheii API în parametrii identifier și password. Valoarea parametrului encryptedPassword trebuie să fie false.
Folosind cheia API, numele de utilizator și parola criptată
- În primul rând, trebuie să utilizați GET /session/encryptionKey și să menționați cheia API generată în Setările platformei în antetul X-CAP-API-KEY. Ca răspuns veți primi parametrii encryptionKey și timeStamp;
- Folosind parametrii encryptionKey și timeStamp primiți, trebuie să criptați parola cheii API folosind metoda de criptare AES.
- Accesați endpoint-ul POST /session, setați valoarea true pentru parametrul encryptedPassword și menționați cheia API primită în Setările platformei în antetul X-CAP-API-KEY, numele de utilizator și parola cheii API criptată în parametrii identifier și password.
La inițierea sesiunii veți primi parametrii CST și X-SECURITY-TOKEN în anteturile răspunsului. Ambele token-uri trebuie utilizate în anteturile fiecărei cereri pe care o trimiteți.