Før du begynder at bruge API'en, skal du godkende for at oprette en session.
Godkendelse:
Der er 2 måder at starte sessionen på:
- Ved at bruge din API-nøgle, login og adgangskode;
- Ved at bruge din API-nøgle, login og krypterede adgangskode.
Ved at bruge din API-nøgle, login og adgangskode
Her skal du blot bruge POST /session-endpointet og angive den modtagne API-nøgle fra platformens Indstillinger i X-CAP-API-KEY-headeren, login og API-nøgle-adgangskodeoplysninger i parametrene identifier og password. Værdien af parameteren encryptedPassword skal være false.
Ved at bruge din API-nøgle, login og krypterede adgangskode
- Først skal du bruge GET /session/encryptionKey og angive den genererede API-nøgle fra platformens Indstillinger i X-CAP-API-KEY-headeren. Som svar modtager du parametrene encryptionKey og timeStamp;
- Ved hjælp af de modtagne parametre encryptionKey og timeStamp skal du kryptere din API-nøgle-adgangskode ved hjælp af AES-krypteringsmetoden.
- Gå til POST /session-endpointet, sæt værdien true for parameteren encryptedPassword og angiv den modtagne API-nøgle fra platformens Indstillinger i X-CAP-API-KEY-headeren, login og den tidligere krypterede API-nøgle-adgangskode i parametrene identifier og password
Ved opstart af sessionen modtager du CST- og X-SECURITY-TOKEN-parametrene i svarheaderne. Begge disse tokens skal bruges i headerne på hver anmodning, du sender.