Security

Here you will find all security related APIs

Authentication

Our services require you to be authenticated and authorized, that's why you must generate your access token first. In order to create this token, you must provide your credential.

Your credential consists of three values: you api key, your secret, your tenant, your env and your banknu.

Your api key must be sent as a header, and also as your username along with your secret as Basic authorization.

Your tenant, env and banknu must be sent as headers values.

post

/id/v1/identity/auth/token

Authorizations

Header parameters

x-api-keystring

Your credential's unique key

Example: YOUR_API_KEY

x-tenantstring

Your credential's tenant value

Example: YOUR_TENANT

x-envstring

Your credential's env value

Example: YOUR_ENV

x-banknustring

Your credential's banknu value

Example: YOUR_BANKNU

user-agentstring

Example: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.77 Safari/537.36

x-interfacenumber

Example: postman-interface-v1.0.0

Body

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-sandbox.preventor.com/id/v1/identity/auth/token' \
  --header 'Authorization: Basic username:password'

200

200

No body

Successful response