stocks.php¶

Модуль управления стоковыми серверами: получение списка доступных предложений и детальная информация о конкретном сервере

Методы API¶

Метод	Действие	Описание
`list`	получение списка	Возвращает список доступных стоковых серверов с учетом локации, группы и прав пользователя.
`show`	получение информации	Возвращает детальную информацию о конкретном сервере.

stocks/list¶

Возвращает список доступных стоковых серверов с учетом локации, группы и прав пользователя.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `list`
token	❌	string	Токен авторизации для проверки прав доступа и фильтрации по стране клиента.
id	❌	integer	Идентификатор (не используется в данном методе).
location	❌	string	Фильтр по локации.
group	❌	string	Фильтр по группе серверов.

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

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

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

{
"result": "OK",
"action": "list",
"servers": [
{
"id": 123,
"name": "Stock Server Example",
"status": "active",
"location": "NL",
"price": {
"EUR": 49.99,
"RUB": 5000
}
}
]
}

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

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

stocks/show¶

Возвращает детальную информацию о конкретном сервере.