You need an API key to authenticate most requests made to Universign’s REST API. An API key is a unique identifier associated with your account. It is necessary for usage and billing purposes. Only users with administrator rights can create API keys.
Create your API key
From the Developer space of your workspace, navigate to the API keys section and click Create an API key.
Note that you can have up to 5 API keys per workspace.
If you delete an API key, you can no longer use to authenticate your requests.
Recommendations
- Name your API key explicitely. It will be easier for you to identify which API key can be deleted, for example.
- Copy your API key and store it in a secure place on your side. For security reasons, Universign does not store API keys in clear text.
Authenticate your request
Once you created your API key, you are ready to authenticate your request. Add it to the request header as the value of the username followed by a colon: -u your_API_key:
(the password field can be left empty).
Alternatively, you can authenticate via bearer auth: -H "Authorization: Bearer your_API_key"
Authentication errors
If you don’t provide an API key or provide an invalid one when authentication is required, you will receive a 401 - Unauthorized
response.
If the API key you provided does not grant you access to the resource, you will receive a 403 - Forbidden
response.