Перейти к содержимому

Обновление токена доступа

POST
/v2/auth/refresh
curl --request POST \
--url https://api-admin.billz.ai/v2/auth/refresh \
--header 'Content-Type: application/json' \
--header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01' \
--data '{ "refresh_token": "REFRESH_TOKEN" }'

Коды ошибок: 400 — ошибка валидации входных данных; 401, 403, 429, 500 — общие для всех методов. Форматы тела и семантика — Коды ответов и ошибки.

platform-id
string
default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Идентификатор платформы. Для интеграций используется статичное значение.

Media typeapplication/json
object
refresh_token
required

Одноразовый refresh-токен. Пустой — 400 invalid_request. Ограничен по длине

string
Example
{
"refresh_token": "REFRESH_TOKEN"
}

Успешный ответ

Media typeapplication/json
object
code

200 при успехе

integer format: int32
message

‘ok’ при успехе; при ошибке — человекочитаемое описание

string
error

Null при успехе; при ошибке — строковый RFC 6749 §5.2 код

integer format: int32
nullable
data
object
token_type

Всегда Bearer

string
access_token

Новый access-токен

string
refresh_token

Новый refresh-токен; отсутствует, если не выпускался

string
expires_in

Время жизни access-токена в секундах

integer format: int32
refresh_expires_in

Время жизни refresh-токена в секундах; отсутствует, если не задано

integer format: int32
Examplegenerated
{
"code": 1,
"message": "example",
"error": 1,
"data": {
"token_type": "example",
"access_token": "example",
"refresh_token": "example",
"expires_in": 1,
"refresh_expires_in": 1
}
}