Authentication

Authentication for all of our back-end REST APIs occurs via HTTP Basic Authentication (Basic Auth). To generate a valid authorization header, pass your base64-encoded Cleverbridge username and password in the authorization request header field, as shown in the following example:

curl --request POST \
  --url 'https://rest.cleverbridge.com/urlgenerator/generateusersessionurl' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  --data '{
    "TargetUrl": "https%3A%2F%2Fwww.cleverbridge.com%2F864%2F%3Fscope%3Dcheckout%26amp%3Bcart%3D97771%26amp%3Blanguage%3Den%26amp%3Bcurrency%3DUSD%26amp%3Bx-source%3Dwebsite-visit-05.2019"
  }'

📘

Note

To use your username and password to authenticate, your Cleverbridge user must have the following privilege - API User. For more information about user account privileges, see User privelleges.

OIDC Authentication

You can also use OpenID Connect framework for authentication. In this case, the authentication is defined in the same way as for GraphQL API. For more details see GraphQL API Authentication.