Innan du börjar använda API:t bör du autentisera dig för att skapa en session.
Autentisering:
Det finns 2 sätt att starta sessionen:
- Använda din API-nyckel, inloggning och lösenordsuppgifter;
- Använda din API-nyckel, inloggning och krypterade lösenordsuppgifter.
Använda din API-nyckel, inloggning och lösenordsuppgifter
Här ska du helt enkelt använda POST /session-endpointen och ange den API-nyckel som erhållits i plattformens Inställningar i X-CAP-API-KEY-headern, inloggning och API-nyckelns lösenordsinformation i parametrarna identifierare och lösenord. Värdet för parametern encryptedPassword ska vara false.
Använda din API-nyckel, inloggning och krypterade lösenordsuppgifter
- Först ska du använda GET /session/encryptionKey och ange den genererade API-nyckeln från plattformens Inställningar i X-CAP-API-KEY-headern. Som svar får du parametrarna encryptionKey och timeStamp;
- Med de mottagna parametrarna encryptionKey och timeStamp ska du kryptera ditt API-nyckellösenord med AES-krypteringsmetoden.
- Gå till POST /session-endpointen, sätt värdet true för parametern encryptedPassword och ange den mottagna API-nyckeln från plattformens Inställningar i X-CAP-API-KEY-headern, inloggning och tidigare krypterade API-nyckellösenordsinformation i parametrarna identifierare och lösenord
När sessionen startas får du CST och X-SECURITY-TOKEN parametrarna i svarshuvudena. Båda dessa token ska användas i headern för varje förfrågan du skickar.