Получение токена доступа
POST
/v1/auth/login
const url = 'https://api-admin.billz.ai/v1/auth/login';const options = { method: 'POST', headers: { 'platform-id': '7d4a4c38-dd84-4902-b744-0488b80a4c01', 'Content-Type': 'application/json' }, body: '{"secret_token":"YOUR_SECRET_KEY"}'};
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/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 — общие для всех методов. Форматы тела и семантика — Коды ответов и ошибки.
Parameters
Заголовок раздела «Parameters»Header Parameters
Заголовок раздела «Header Parameters»platform-id
string
Идентификатор платформы. Для интеграций используется статичное значение.
Request Bodyrequired
Заголовок раздела «Request Bodyrequired»Media typeapplication/json
object
secret_token
required
Секретный ключ интеграции. Пустая строка — 403
string
Example
{ "secret_token": "YOUR_SECRET_KEY"}Responses
Заголовок раздела «Responses»Успешный ответ
Media typeapplication/json
object
code
Дублирует HTTP-статус (200)
integer format: int32
message
‘ok’ при успехе
string
error
Null при успехе
integer format: int32
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 }}