Než začnete používat API, měli byste se autentizovat pro vytvoření relace.
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ých údajů hesla.
Použitím vašeho API klíče, přihlašovacího jména a hesla
Zde jednoduše použijte endpoint POST /session a uveďte API klíč získaný v Nastavení platformy v hlavičce X-CAP-API-KEY, přihlašovací jméno a heslo API klíče v parametrech identifier a password. Hodnota parametru encryptedPassword by měla být false.
Použitím vašeho API klíče, přihlašovacího jména a zašifrovaných údajů hesla
- Nejprve byste měli použít GET /session/encryptionKey a uvést v hlavičce X-CAP-API-KEY API klíč vygenerovaný v Nastavení platformy. Jako odpověď obdržíte parametry encryptionKey a timeStamp;
- Pomocí obdržených parametrů encryptionKey a timeStamp byste měli zašifrovat své heslo API klíče pomocí metody AES šifrování.
- Přejděte na endpoint POST /session, nastavte hodnotu true pro parametr encryptedPassword a uveďte API klíč získaný v Nastavení platformy v hlavičce X-CAP-API-KEY, přihlašovací jméno a předem 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 třeba používat v hlavičkách každého odeslaného požadavku.