Voordat u de API gaat gebruiken, moet u zich authenticeren om een sessie te creëren.
Authenticatie:
Er zijn 2 manieren om de sessie te starten:
- Met uw API-sleutel, login en wachtwoordgegevens;
- Met uw API-sleutel, login en versleutelde wachtwoordgegevens.
Met uw API-sleutel, login en wachtwoordgegevens
Hier gebruikt u eenvoudig het POST /session eindpunt en vermeldt u de in de instellingen van het platform ontvangen API-sleutel in de X-CAP-API-KEY header, login en API-sleutel wachtwoordgegevens in de identifier en password parameters. De waarde van de encryptedPassword parameter moet false zijn.
Met uw API-sleutel, login en versleutelde wachtwoordgegevens
- Allereerst moet u het GET /session/encryptionKey eindpunt gebruiken en de in de instellingen van het platform gegenereerde API-sleutel vermelden in de X-CAP-API-KEY header. Als antwoord ontvangt u de encryptionKey en timeStamp parameters;
- Met de ontvangen encryptionKey en timeStamp parameters moet u uw API-sleutel wachtwoord versleutelen met behulp van de AES-encryptiemethode.
- Ga naar het POST /session eindpunt, zet de waarde van de encryptedPassword parameter op true en vermeld de in de instellingen van het platform ontvangen API-sleutel in de X-CAP-API-KEY header, login en het eerder versleutelde API-sleutel wachtwoord in de identifier en password parameters.
Na het starten van de sessie ontvangt u de CST- en X-SECURITY-TOKEN-parameters in de response headers. Beide tokens moeten worden gebruikt in de headers van elk verzoek dat u verzendt.