Înainte de a începe să utilizați API-ul, trebuie să vă autentificați pentru a crea o sesiune.
Autentificare:
Există 2 moduri de a începe sesiunea:
- Folosind cheia dvs. API, detaliile de login și parolă;
- Folosind cheia dvs. API, login și detalii despre parola criptată.
Aici trebuie pur și simplu să folosiți endpoint-ul POST /session și să menționați cheia API primită în Setările platformei în headerul X-CAP-API-KEY, iar informațiile de login și parola cheii API în parametrii identifier și password. Valoarea parametrului encryptedPassword trebuie să fie false.
- În primul rând, trebuie să folosiți endpoint-ul GET /session/encryptionKey și să menționați cheia API generată în Setările platformei în headerul 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 headerul X-CAP-API-KEY, login-ul și informațiile despre parola cheii API crptată anterior în parametrii identifier și password
După ce ați început sesiunea, veți primi parametrii CST și X-SECURITY-TOKEN în header-ele răspunsului. Ambii acești tokeni trebuie folosiți în header-ele fiecărei cereri pe care o trimiteți.