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

Получение токена доступа

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

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

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

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

Media typeapplication/json
object
secret_token
required

Секретный ключ интеграции. Пустая строка — 403

string
Example
{
"secret_token": "YOUR_SECRET_KEY"
}

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

Media typeapplication/json
object
code

Дублирует HTTP-статус (200)

integer format: int32
message

‘ok’ при успехе

string
error

Null при успехе

integer format: int32
nullable
data

Токены доступа

object
access_token

JWT access-токен для заголовка Authorization: Bearer

string
refresh_token

Одноразовый refresh-токен для POST /v2/auth/refresh

string
token_type

Всегда Bearer

string
expires_in

Время жизни access_token в секундах

integer format: int32
key
additional properties
any
Examplegenerated
{
"code": 1,
"message": "example",
"error": 1,
"data": {
"access_token": "example",
"refresh_token": "example",
"token_type": "example",
"expires_in": 1
}
}