hardware.php¶

Модуль управления аппаратным обеспечением: управление штрих-кодами компонентов, их добавление, удаление, обновление и получение списков.

Методы API¶

Метод	Действие	Описание
`add_barcodes`	добавление штрих-кодов	Добавляет новые штрих-коды для сущности оборудования.
`delete_barcodes`	удаление штрих-кодов	Удаляет штрих-код, привязанный к конкретной сущности.
`list_barcodes`	получение списка штрих-кодов	Возвращает список всех доступных штрих-кодов с учетом фильтрации.
`show_barcodes`	просмотр штрих-кода	Возвращает информацию о конкретном штрих-коде по его ID.
`update_barcodes`	обновление штрих-кодов	Обновляет данные существующего штрих-кода.

Добавляет новые штрих-коды для сущности оборудования.

HTTP-метод: POST

Параметры:

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

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

curl -s "https://invapi.hostkey.ru/hardware.php" -X POST \
--data "action=add_barcodes" \
--data "token=HOSTKEY_TOKEN" \
--data "id=123"

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

{
"result": "OK",
"action": "add_barcodes",
"barcode": 12345
}

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

{
"code": -1,
"message": "Ошибка выполнения операции"
}

Удаляет штрих-код, привязанный к конкретной сущности.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `delete_barcodes`
token	✅	string	Токен авторизации
id	❌	integer	Идентификатор штрих-кода или сущности для удаления

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

curl -s "https://invapi.hostkey.ru/hardware.php" -X POST \
--data "action=delete_barcodes" \
--data "token=YOUR_TOKEN" \
--data "id=12345"

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

{
"result": "OK",
"action": "delete_barcodes",
"barcode": 12345
}

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

{
"code": -1,
"message": "Ошибка удаления штрих-кода"
}

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

HTTP-метод: POST

Параметры:

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

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

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

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

{
"result": "OK",
"action": "list_barcodes",
"barcodes": [
{
"id": 1,
"code": "ABC-123",
"entity_type": "component"
}
]
}

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

{
"code": -1,
"message": "Ошибка получения списка"
}

Возвращает информацию о конкретном штрих-коде по его ID.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `show_barcodes`
token	✅	string	Токен авторизации
id	❌	integer	Идентификатор штрих-кода

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

curl -s "https://invapi.hostkey.ru/hardware.php" -X POST \
--data "action=show_barcodes" \
--data "token=HOSTKEY_TOKEN" \
--data "id=1"

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

{
"result": "OK",
"action": "show_barcodes",
"barcode": {
"id": 1,
"code": "ABC-123",
"entity_type": "component"
}
}

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

{
"code": -1,
"message": "Штрих-код не найден"
}

Обновляет данные существующего штрих-кода.

HTTP-метод: POST

Параметры:

Параметр	Обязательный	Тип	Описание
action	✅	string	Идентификатор метода: `update_barcodes`
token	✅	string	Токен авторизации
id	❌	integer	Идентификатор штрих-кода для обновления

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

curl -s "https://invapi.hostkey.ru/hardware.php" -X POST \
--data "action=update_barcodes" \
--data "token=HOSTKEY_TOKEN" \
--data "id=1"

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

{
"result": "OK",
"action": "update_barcodes",
"barcode": {
"id": 1,
"code": "UPDATED-001",
"entity_type": "component"
}
}

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

{
"code": -1,
"message": "Ошибка обновления штрих-кода"
}