Обновление токена доступа
POST
/v2/auth/refresh
const url = 'https://api-admin.billz.ai/v2/auth/refresh';const options = { method: 'POST', headers: { 'platform-id': '7d4a4c38-dd84-4902-b744-0488b80a4c01', 'Content-Type': 'application/json' }, body: '{"refresh_token":"REFRESH_TOKEN"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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 — общие для всех методов. Форматы тела и семантика — Коды ответов и ошибки.
Parameters
Заголовок раздела «Parameters»Header Parameters
Заголовок раздела «Header Parameters»platform-id
string
Идентификатор платформы. Для интеграций используется статичное значение.
Request Bodyrequired
Заголовок раздела «Request Bodyrequired»Media typeapplication/json
object
refresh_token
required
Одноразовый refresh-токен. Пустой — 400 invalid_request. Ограничен по длине
string
Example
{ "refresh_token": "REFRESH_TOKEN"}Responses
Заголовок раздела «Responses»Успешный ответ
Media typeapplication/json
object
code
200 при успехе
integer format: int32
message
‘ok’ при успехе; при ошибке — человекочитаемое описание
string
error
Null при успехе; при ошибке — строковый RFC 6749 §5.2 код
integer format: int32
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 }}