Преди да започнете да използвате API, трябва да се удостоверите, за да създадете сесия.
Удостоверяване:
Има 2 начина за стартиране на сесията:
- Използване на вашия API ключ, потребителско име и парола;
- Използване на вашия API ключ, потребителско име и криптирана парола.
Използване на вашия API ключ, потребителско име и парола
Тук просто трябва да използвате POST /session крайна точка и да посочите получения в настройките на платформата API ключ в заглавката X-CAP-API-KEY, информацията за потребителското име и парола на API ключа в параметрите identifier и password. Стойността на параметъра encryptedPassword трябва да бъде false.
Използване на вашия API ключ, потребителско име и криптирана парола
- Първо трябва да използвате GET /session/encryptionKey и да посочите генерирания в настройките на платформата API ключ в заглавката X-CAP-API-KEY. Като отговор ще получите параметрите encryptionKey и timeStamp;
- Използвайки получените параметри encryptionKey и timeStamp, трябва да криптирате паролата на вашия API ключ, използвайки AES метод за криптиране.
- Отидете на POST /session крайна точка, задайте стойност true за параметъра encryptedPassword и посочете получения в настройките на платформата API ключ в заглавката X-CAP-API-KEY, потребителското име и предварително криптираната парола на API ключа в параметрите identifier и password
След стартиране на сесията ще получите параметрите CST и X-SECURITY-TOKEN в заглавките на отговора. И двата токена трябва да се използват в заглавките на всяка заявка, която изпращате.