Login
Exchanges the Partner-issued credentials (LOGIN, PASSWORD) for a short-lived bearer token. The token must be sent in the Authorization header of every other request. See Authentication for the caching and refresh behaviour.
Endpoint
Method: POST
URL: /v1/login
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| └ login | String | Yes | Partner-issued login |
| └ password | String | Yes | Partner-issued password |
Request Example
json
{
"login": "{{LOGIN}}",
"password": "{{PASSWORD}}"
}Response Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| └ token | String | Yes | Bearer token to send as Authorization: Bearer <token> on all other requests |
| └ expires_in | Integer | Yes | Token lifetime in seconds |
Response Example
json
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_in": 3600
}Error Code List
| code | message | Description |
|---|---|---|
| UNAUTHORIZED | Invalid credentials | The supplied login/password pair was rejected (401). |