auth.php¶

API module for authentication management, including 2FA verification, session handling, and SSO integration.

Методы API¶

Метод	Действие	Описание
`2fa_check`	проверка 2FA	Проверяет введенный код двухфакторной аутентификации и возвращает данные сессии.
`2fa_resend`	повторная отправка 2FA	Запрашивает повторную отправку кода двухфакторной аутентификации.
`billing_list`	получение списка биллингов	Возвращает список доступных платежных систем (биллингов).
`email_check`	проверка email	Проверяет существование пользователя по email и отправляет код верификации.
`flip_tag`	переключение тега	Создает или удаляет тег у пользователя.
`get_log_details`	получение деталей лога	Возвращает детализированные логи аутентификации для пользователя.
`github_init`	инициализация GitHub SSO	Инициирует процесс авторизации через GitHub.
`github_signin`	инициализация входа через GitHub	Инициирует процесс OAuth авторизации через GitHub, генерируя state и redirect URI.
`google_signin`	авторизация через Google SSO	Валидирует Google ID Token и привязывает его к текущей сессии или аккаунту.
`info`	получение информации о токене	Возвращает данные текущей сессии (роль, права, email, серверы) на основе токена.
`ipalogin`	вход через FreeIPA (LDAP)	Выполняет аутентификацию пользователя в LDAP/FreeIPA и создает сессию.
`list_hashes`	получение списка хешей (заглушка)	Метод не реализован.
`login`	вход по API ключу	Авторизация клиента с использованием долгосрочного API ключа.
`logout`	выход из системы	Удаляет текущий токен доступа.
`register`	регистрация	Метод не реализован (die).
`session_reset`	сброс сессии	Сбрасывает все активные сессии пользователя, если предоставлен верный токен сброса.
`set_tag`	установка тега	Создает или удаляет тег пользователя.
`sms_check`	проверка номера SMS	Проверяет номер телефона на доступность для отправки SMS.
`sms_send`	отправка SMS	Отправляет код верификации на номер телефона.
`sms_validate`	валидация SMS	Проверяет введенный пользователем код верификации через Twilio.
`tg_verify`	верификация Telegram	Привязывает username Telegram к аккаунту пользователя.
`unregister`	не реализовано	Метод не реализован (die).
`validate`	не реализовано	Метод не реализован (break).
`validate_login`	проверка учетных данных WHMCS	Проверяет валидность логина и пароля в доступных биллинговых системах (WHMCS).
`vk_init`	инициализация VK OAuth	Инициирует процесс авторизации через VK, возвращает данные для клиентской части.
`vk_signin`	авторизация через VK	Завершает процесс авторизации через VK, обменивая код на сессию.
`whmcslogin`	вход через WHMCS (SSO или логин/пароль)	Выполняет вход в систему через учетные данные WHMCS или с помощью SSO провайдеров.

auth/2fa_check¶

Проверяет введенный код двухфакторной аутентификации и возвращает данные сессии.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `2fa_check`
token	✅	string	Токен сессии для проверки двухфакторной аутентификации.
user_token	❌	string	Код двухфакторной аутентификации для проверки.
ttl	❌	integer	Время жизни токена в секундах.
device_id	❌	string	Уникальный идентификатор устройства пользователя.
state	❌	string	Текущее состояние сессии или процесса аутентификации.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=2fa_check" \
--data "token=YOUR_TOKEN" \
--data "user_token=123456"

Пример успешного ответа

{
"result": "2FA OK",
"token": "string",
"token_expire": 1700000000,
"userid": 12345,
"corporate": false,
"country_code": "US",
"currency_code": "USD",
"VisitorID": "string|null"
}

Примеры ошибок

{
"code": -2,
"message": "Invalid token"
}

auth/2fa_resend¶

Запрашивает повторную отправку кода двухфакторной аутентификации.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `2fa_resend`
token	✅	string	Токен сессии для аутентификации.
from	❌	string	Источник запроса (например, user_profile).
user	❌	string	Электронная почта пользователя для отправки кода двухфакторной аутентификации.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=2fa_resend" \
--data "token=HOSTKEY_TOKEN" \
--data "user=example@mail.com"

Пример успешного ответа

{
"result": "OK",
"message": "2FA token sent"
}

Примеры ошибок

{
"code": -1,
"message": "Invalid token"
}

auth/billing_list¶

Возвращает список доступных платежных систем (биллингов).

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `billing_list`
token	❌	string	Токен сессии для авторизации пользователя.
device_id	❌	integer	Уникальный идентификатор устройства для фильтрации списка биллингов.
state	❌	string	Текущее состояние или статус записи в системе биллинга.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=billing_list"

Пример успешного ответа

{
"result": "OK",
"billings": "array<object>"
}

Примеры ошибок

{
"code": -2,
"message": "Invalid hash"
}

auth/email_check¶

Проверяет существование пользователя по email и отправляет код верификации.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `email_check`
user_email	✅	string	Электронная почта пользователя для проверки и отправки кода верификации.
location	✅	string	Идентификатор биллинговой локации (whmcs location).
user_token	❌	string	Токен верификации для подтверждения выполнения действия.
device_id	❌	string	Уникальный идентификатор устройства.
state	❌	string	Текущее состояние процесса или статус проверки.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=email_check" \
--data "user_email=example@mail.com" \
--data "location=whmcs_loc_1"

Пример успешного ответа

{
"result": "OK",
"state": "sent|verified",
"smtp": "object|null",
"message": "string",
"status": "string"
}

Примеры ошибок

{
"code": "INVALID_EMAIL",
"message": "Invalid email"
}

auth/flip_tag¶

Создает или удаляет тег у пользователя.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `flip_tag`
token	✅	string	Токен сессии.
tag	✅	string	Имя тега. Допустимые значения: server_id, %.
device_id	❌	integer	Уникальный идентификатор устройства.
state	❌	string	Текущее состояние или статус объекта.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=flip_tag" \
--data "token=HOSTKEY_TOKEN" \
--data "tag=server_id"

Пример успешного ответа

{
"result": "OK",
"message": "string",
"action": "created|removed"
}

Примеры ошибок

{
"code": -1,
"message": "tag is missing",
"error_code": "TAG_MISSING"
}

auth/github_init¶

Инициирует процесс авторизации через GitHub.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `github_init`
device_id	❌	string	Уникальный идентификатор устройства для привязки сессии.
state	❌	string	Состояние безопасности для защиты от CSRF-атак при авторизации через GitHub.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=github_init"

Пример успешного ответа

{
"result": "OK",
"data": {
"client_id": "string",
"redirect_uri": "string",
"state": "string"
},
"error_code": null
}

Примеры ошибок

{
"code": -1,
"message": "sso_github_unavailable",
"error_code": "SSO_UNAVAILABLE"
}

auth/github_signin¶

Инициирует процесс OAuth авторизации через GitHub, генерируя state и redirect URI.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `github_signin`
state	❌	string	Состояние OAuth для проверки целостности сессии.
code	✅	string	Код авторизации, полученный от GitHub.
token	❌	string	API-токен аутентификации для проверки прав доступа пользователя.
device_id	❌	string	Уникальный идентификатор устройства пользователя.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=github_signin" \
--data "code=VALUE"

Пример успешного ответа

{
"result": "OK",
"action": "github_signin",
"data": {
"client_id": "string",
"redirect_uri": "string",
"state": "string"
}
}

Примеры ошибок

{
"code": -1,
"message": "SSO_UNAVAILABLE. Допустимые значения: SSO_UNAVAILABLE."
}

auth/google_signin¶

Валидирует Google ID Token и привязывает его к текущей сессии или аккаунту.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `google_signin`
credential	✅	string	Google ID Token (JWT) для аутентификации пользователя.
token	❌	string	Существующий токен сессии для привязки Google к аккаунту.
device_id	❌	string	Уникальный идентификатор устройства пользователя.
state	❌	string	Состояние или дополнительный контекстный параметр запроса.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=google_signin" \
--data "credential=VALUE"

Пример успешного ответа

{
"result": "OK",
"sso_set": -1,
"error_code": null
}

Примеры ошибок

{
"code": -3,
"message": "sso_google_unavailable"
}

auth/info¶

Возвращает данные текущей сессии (роль, права, email, серверы) на основе токена.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: info
token	✅	string	Валидный токен сессии.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=info" \
--data "token=HOSTKEY_TOKEN"

Пример успешного ответа

{
"result": "OK",
"action": "info",
"token": "string",
"role": "string",
"role_type": "Customer|Employee",
"permissions": ["string"],
"whmcs_id": 0,
"whmcs_location": "string",
"customer_id": 0,
"server_data_incomplete": false,
"subaccount": "string",
"prebill_global": false,
"s3": false,
"original_tags": ["string"],
"has_product_subscription": false,
"email": "string",
"edit_master_profile": false,
"manage_orders": false,
"token_expire": 0,
"billing_servers": [0],
"show_products": false,
"deploy_keys": ["string"],
"manage_products": false,
"show_invoices": false,
"ipsubnet_announce": false,
"prebill_scope": "string",
"prebill": false,
"managed_apps": false,
"role_name": "string",
"verified": false,
"sumsub_id": "string",
"sumsub_comment": "string",
"corporate": false,
"tags": ["string"],
"default_lang": "string",
"private_ranges": ["string"],
"private_vlans": ["string"],
"prebill_pending": [0],
"prebill_balance": 0.0,
"billing_options": {},
"client_ip": "string",
"timing": []
}

Примеры ошибок

{
"code": -2,
"message": "Invalid token"
}

auth/ipalogin¶

Выполняет аутентификацию пользователя в LDAP/FreeIPA и создает сессию.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `ipalogin`
user	✅	string	Имя пользователя для аутентификации в LDAP.
password	✅	string	Пароль пользователя.
server_id	❌	string	ID сервера для привязки сессии. Допустимые значения: server_id, %.
geo_lat	❌	string	Широта географических координат пользователя.
geo_long	❌	string	Долгота географических координат пользователя.
fix_ip	❌	boolean	Флаг фиксации IP-адреса для привязки сессии к текущему адресу.
ttl	❌	integer	Время жизни токена авторизации в секундах.
device_id	❌	string	Идентификатор устройства для привязки сессии.
state	❌	string	Состояние или дополнительный параметр запроса авторизации.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=ipalogin" \
--data "user=VALUE" \
--data "password=VALUE"

Пример успешного ответа

{
"token": "string",
"role": "string",
"role_type": "Employee",
"permissions": [
"string"
],
"token_expire": "integer",
"ldap_email": "string"
}

Примеры ошибок

{
"code": -2,
"message": "LDAP_AUTHENTICATION_ERROR. Ошибка аутентификации в LDAP."
}

auth/list_hashes¶

Метод не реализован.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `list_hashes`

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=list_hashes"

Пример успешного ответа

{
"result": null
}

Примеры ошибок

[]

auth/login¶

Авторизация клиента с использованием долгосрочного API ключа.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: login
key	✅	string	API ключ клиента в формате xxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx.
ttl	❌	integer	Время жизни токена сессии в секундах.
fix_ip	❌	integer	Флаг фиксации IP-адреса для сессии авторизации.
base	❌	string	Базовый URL адрес для формирования инвапи-ссылок.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=login" \
--data "key=xxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx"

Пример успешного ответа

{
"token": "string",
"role": "string",
"role_type": "Customer|server ID",
"whmcs_id": "integer",
"whmcs_location": "string",
"servers": "array<integer>",
"invapi": "string",
"customer_id": "integer",
"permissions": "array<string>",
"token_expire": "integer",
"new": "boolean",
"prebill": "boolean",
"prebill_scope": "string",
"prebill_global": "boolean"
}

Примеры ошибок

{
"code": -1,
"message": "API_KEY_EMPTY. Ключ не указан."
}

auth/logout¶

Удаляет текущий токен доступа.

HTTP-метод: POST

Параметры:

action	✅	string	Идентификатор метода: `logout`

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=logout"

Пример успешного ответа

{
"result": "OK",
"message": "access token cleared"
}

Примеры ошибок

{
"code": -2,
"message": "TOKEN_REQUIRED. Токен не указан."
}

auth/register¶

Метод не реализован (die).

HTTP-метод: POST

Параметры:

action	✅	string	Идентификатор метода: `register`

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=register"

Пример успешного ответа

{
"result": "OK",
"action": "register"
}

Примеры ошибок

{
"code": -2,
"message": "Malformed request"
}

auth/session_reset¶

Сбрасывает все активные сессии пользователя, если предоставлен верный токен сброса.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `session_reset`
confirm	❌	integer	Подтверждение действия (1 для выполнения).
user_email	✅	string	Электронная почта пользователя для сброса сессий.
reset_token	✅	string	Специальный токен сброса (6 символов: первые 3 и последние 3 от логин-токена).

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=session_reset" \
--data "user_email=example@mail.com" \
--data "reset_token=ABCXYZ"

Пример успешного ответа

{
"result": "OK",
"action": "session_reset"
}

Примеры ошибок

{
"code": -2,
"message": "Malformed request"
}

auth/set_tag¶

Создает или удаляет тег пользователя.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `set_tag`
token	✅	string	Токен авторизации.
tag	✅	string	Имя тега. Допустимые значения: server_id, %
set	✅	boolean	Флаг установки (true) или удаления (false) тега.
device_id	❌	integer	Уникальный идентификатор устройства.
state	❌	string	Текущее состояние или статус объекта.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=set_tag" \
--data "token=HOSTKEY_TOKEN" \
--data "tag=server_id" \
--data "set=true"

Пример успешного ответа

{
"result": "OK",
"message": "string",
"action": "set|unset|absence",
"error_code": null
}

Примеры ошибок

{
"code": -1,
"message": "Invalid token"
}

auth/sms_check¶

Проверяет номер телефона на доступность для отправки SMS.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `sms_check`
number	✅	string	Номер телефона в формате E.164 (начинается с +).
device_id	❌	integer	Уникальный идентификатор устройства.
state	❌	string	Текущее состояние или статус процесса.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=sms_check" \
--data "number=+79991234567"

Пример успешного ответа

{
"result": "OK",
"message": "Verification SMS sent to <number>"
}

Примеры ошибок

{
"code": -2,
"message": "Phone number is required"
}

auth/sms_send¶

Отправляет код верификации на номер телефона.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `sms_send`
token	✅	string	Токен авторизации.
user_token	✅	string	Номер телефона пользователя для отправки SMS верификации.
code	❌	string	Код подтверждения для завершения верификации номера.
device_id	❌	string	Идентификатор устройства пользователя.
state	❌	string	Текущее состояние процесса верификации или результат операции.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=sms_send" \
--data "token=YOUR_TOKEN" \
--data "user_token=79991234567"

Пример успешного ответа

{
"result": "OK",
"message": "The verification token sent to ***<last_3_digits>",
"state": "verified"
}

Примеры ошибок

{
"code": "INVALID_TOKEN",
"message": "Invalid token"
}

auth/sms_validate¶

Проверяет введенный пользователем код верификации через Twilio.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: sms_validate
number	✅	string	Номер телефона в формате E.164 (должен начинаться с +).
code	✅	string	Код верификации пользователя.
device_id	❌	integer	Уникальный идентификатор устройства пользователя.
state	❌	string	Текущее состояние или статус процесса верификации.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=sms_validate" \
--data "number=+79991234567" \
--data "code=123456"

Пример успешного ответа

{
"result": "OK",
"message": "Verification successful"
}

Примеры ошибок

{
"code": "SMS_VERIFICATION_EXPIRED",
"message": "Verification timeout, please try again"
}

auth/tg_verify¶

Привязывает username Telegram к аккаунту пользователя.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `tg_verify`
token	✅	string	Токен авторизации.
tg_username	✅	string	Имя пользователя Telegram для верификации аккаунта.
user_email	❌	string	Электронная почта пользователя для идентификации в системе.
client_id	❌	integer	Уникальный идентификатор клиента.
location	❌	string	Местоположение или локация пользователя.
device_id	❌	string	Уникальный идентификатор устройства пользователя.
state	❌	string	Текущее состояние или статус процесса верификации.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=tg_verify" \
--data "token=VALUE" \
--data "tg_username=VALUE"

Пример успешного ответа

{
"result": "OK",
"bot_url": "string"
}

Примеры ошибок

{
"code": -1,
"message": "Illegal TG username"
}

auth/unregister¶

Метод не реализован (die).

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: unregister

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=unregister"

Пример успешного ответа

{
"result": -2,
"error": "Malformed request",
"code": "MALFORMED_REQUEST"
}

Примеры ошибок

{
"code": -2,
"message": "Malformed request"
}

auth/validate¶

Метод не реализован (break).

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: validate

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=validate"

Пример успешного ответа

{
"result": null,
"action": "validate"
}

Примеры ошибок

[]

auth/validate_login¶

Проверяет валидность логина и пароля в доступных биллинговых системах (WHMCS).

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `validate_login`
user	✅	string	Логин пользователя (email).
password	✅	string	Пароль пользователя.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=validate_login" \
--data "user=VALUE" \
--data "password=VALUE"

Пример успешного ответа

{
"result": "OK"
}

Примеры ошибок

{
"code": -2,
"message": "Username is empty"
}

auth/vk_init¶

Инициирует процесс авторизации через VK, возвращает данные для клиентской части.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `vk_init`
state	✅	string	Параметр состояния для защиты от CSRF-атак.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=vk_init" \
--data "state=VALUE"

Пример успешного ответа

{
"result": "OK",
"data": {
"client_id": "string",
"redirect_uri": "string",
"code_challenge": "string",
"device_id": "string",
"state": "string"
}
}

Примеры ошибок

{
"code": -1,
"message": "SSO_UNAVAILABLE"
}

auth/vk_signin¶

Завершает процесс авторизации через VK, обменивая код на сессию.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `vk_signin`
state	✅	string	Состояние OAuth (содержит ID сессии). Передается через GET.
code	✅	string	Код авторизации от VK. Передается через GET.
device_id	✅	string	ID устройства из vk_init. Передается через GET.
token	❌	string	API-токен аутентификации для проверки сессии пользователя.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=vk_signin" \
--data "state=VALUE" \
--data "code=VALUE" \
--data "device_id=VALUE"

Пример успешного ответа

{
"result": "OK",
"action": "vk_signin"
}

Примеры ошибок

{
"code": -1,
"message": "Invalid host header"
}

auth/whmcslogin¶

Выполняет вход в систему через учетные данные WHMCS или с помощью SSO провайдеров.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `whmcslogin`
sso	❌	string	Метод SSO. Допустимые значения: google, github, vk.
sso_hash	❌	string	Хеш/токен от провайдера SSO.
user	❌	string	Email пользователя (для обычного входа).
password	❌	string	Пароль пользователя.
VisitorID	❌	string	Уникальный идентификатор посетителя для привязки к аккаунту клиента.
web_ip	❌	string	IP-адрес веб-сайта или пользователя для логирования и проверки доступа.
location	❌	string	Выбранный регион или платежный сервис для авторизации в WHMCS.
apikey	❌	string	API-ключ для аутентификации запроса к системе.
customer_data	❌	boolean	Флаг запроса полных данных клиента при успешном входе.
fix_ip	❌	integer	Параметр фиксации IP-адреса для привязки сессии к конкретному адресу.
ttl	❌	integer	Время жизни токена авторизации в секундах.
device_id	❌	string	Идентификатор устройства пользователя.
state	❌	string	Состояние или статус сессии авторизации.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=whmcslogin" \
--data "user=example@mail.com" \
--data "password=secret"

Пример успешного ответа

{
"result": "OK",
"action": "whmcslogin",
"token": "string",
"role": "string",
"role_type": "Customer|Employee",
"whmcs_id": 123,
"whmcs_location": "string",
"permissions": ["permission1", "permission2"],
"customer_id": 456
}

Примеры ошибок

{
"code": -2,
"message": "Invalid credential"
}

auth/get_log_details¶

Возвращает детализированные логи аутентификации для пользователя.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `get_log_details`
token	✅	string	Токен для валидации сессии.
user_token	❌	string	Уникальный идентификатор пользователя для получения подробной информации из логов.

Пример запроса

curl -s "https://invapi.hostkey.ru/auth.php" -X POST \
--data "action=get_log_details" \
--data "token=HOSTKEY_TOKEN" \
--data "user_token=USER_TOKEN"

Пример успешного ответа

{
"result": "OK",
"log": []
}

Примеры ошибок

{
"code": 404,
"message": "Invalid period or log is empty",
"AUTH_LOG_NOT_FOUND": "AUTH_LOG_NOT_FOUND"
}