Před zahájením používání API byste se měli autentizovat a vytvořit relaci.
Autentizace:
Existují 2 způsoby, jak zahájit relaci:
- Použitím vašeho API klíče, přihlašovacího jména a hesla;
- Použitím vašeho API klíče, přihlašovacího jména a zašifrovaného hesla.
Zde byste měli jednoduše použít endpoint POST /session a uvést v hlavičce X-CAP-API-KEY obdržený API klíč v Nastavení platformy, přihlašovací jméno a heslo API klíče v parametrech identifier a password. Hodnota parametru encryptedPassword by měla být false.
- Nejprve byste měli použít GET /session/encryptionKey a uvést v hlavičce X-CAP-API-KEY vygenerovaný API klíč v Nastavení platformy. Jako odpověď obdržíte parametry encryptionKey a timeStamp;
- Pomocí obdržených parametrů encryptionKey a timeStamp byste měli zašifrovat heslo vašeho API klíče pomocí metody AES šifrování.
- Přejděte na endpoint POST /session, nastavte hodnotu true pro parametr encryptedPassword a uveďte v hlavičce X-CAP-API-KEY obdržený API klíč v Nastavení platformy, přihlašovací jméno a dříve zašifrované heslo API klíče v parametrech identifier a password
Po zahájení relace obdržíte parametry CST a X-SECURITY-TOKEN v hlavičkách odpovědi. Oba tyto tokeny je nutné použít v hlavičkách každého požadavku, který odesíláte.