Prije nego što počnete koristiti API, trebate se autentificirati kako biste kreirali sesiju.
Autentifikacija:
Postoje 2 načina za pokretanje sesije:
- Korištenjem vašeg API ključa, korisničkog imena i lozinke;
- Korištenjem vašeg API ključa, korisničkog imena i šifriranih podataka lozinke.
Korištenjem vašeg API ključa, korisničkog imena i lozinke
Ovdje jednostavno trebate koristiti POST /session endpoint i navesti API ključ primljen u postavkama platforme u zaglavlju X-CAP-API-KEY, korisničko ime i lozinku API ključa u parametrima identifier i password. Vrijednost parametra encryptedPassword treba biti false.
Korištenjem vašeg API ključa, korisničkog imena i šifriranih podataka lozinke
- Prvo trebate koristiti GET /session/encryptionKey i navesti generirani API ključ iz postavki platforme u zaglavlju X-CAP-API-KEY. Kao odgovor ćete dobiti parametre encryptionKey i timeStamp;
- Koristeći primljene parametre encryptionKey i timeStamp trebate šifrirati svoju lozinku API ključa koristeći AES metodu enkripcije.
- Idite na POST /session endpoint, postavite vrijednost true za parametar encryptedPassword i navedite primljeni API ključ iz postavki platforme u zaglavlju X-CAP-API-KEY, korisničko ime i prethodno šifriranu lozinku API ključa u parametrima identifier i password
Nakon pokretanja sesije primit ćete parametre CST i X-SECURITY-TOKEN u zaglavljima odgovora. Oba ova tokena trebaju se koristiti u zaglavljima svakog zahtjeva koji šaljete.