POST method only
Use this web service every time you need to request a certificate to identify yourself in subsequent requests to the API. For security reasons, the certificate will expire 60 seconds after its creation.
To create a certificate for yourself, you need to provide your user_token to the web service. Please, check this to understand where to find this parameter.
| Environment | Endpoint |
|---|---|
| Testing | https://testapi.tidisystem.com/auth/ |
| Production | https://api.tidisystems.com/auth/ |
Input:
Body:
| Key | Required | Type | Description |
| user_token | True | string | The randomly generated alphanumeric string when creating your PSI user account |
Headers:
None
Output:
| 1st level JSON | 2nd level JSON | Type | Description |
|
user_cert |
string | The certificate with the credentials to make subsequent calls to the API | |
|
status |
string | “OK” if the request was correct; “NOK” otherwise | |
|
http_status |
int | The HTTP status code | |
|
error_trace: |
[ |
list | List of errors' data that occurred during the request |
|
{ |
dict | ||
|
error_name |
string | The error that occurred during the request. You may retrieve more information about it with parameter “errors_url” | |
|
error_message |
string | The explanation of the error | |
|
error_code |
string | The internal error code, in case you need to contact support to get it fixed. | |
|
} |
|||
|
] |
|||
|
errors_url |
string | The URL to the list of errors, to retrieve more information |