Первый запрос к API

Прочитаем товары из проекта. Эта проверка не печатает этикетки и не меняет данные.

Сначала установите API и подключите проект SQLite с хотя бы одним товаром. Нужен токен, сохранённый при установке. Выполняйте команды на компьютере со службой; для другого адреса сначала настройте сетевой доступ.

Проверить API из PowerShell

Откройте PowerShell. Все три шага выполните в одном окне. Команды подходят для Windows PowerShell 5.1 и используют стандартный порт 5084.

Проверить службу и токен

Скопируйте весь блок и выполните его. Когда PowerShell попросит токен, введите его. Символы будут скрыты.

$baseUrl = 'http://127.0.0.1:5084'
$token = Read-Host 'Токен API' -AsSecureString
$headers = @{ Authorization = 'Bearer ' + [Net.NetworkCredential]::new('', $token).Password }
Invoke-RestMethod -Uri "$baseUrl/api/v1/health" -Headers $headers | ConvertTo-Json

Ожидаемый ответ; время будет другим:

{
  "status": "ok",
  "service": "LabelRedo API",
  "timeUtc": "2026-11-05T08:30:00+00:00"
}

status: "ok" означает, что служба отвечает и принимает токен. Доступ к проекту проверим отдельно.

Проверить проект

Invoke-RestMethod -Uri "$baseUrl/api/v1/project/status" -Headers $headers |
    Select-Object isConfigured, isValid, isDatabaseReachable |
    ConvertTo-Json

Успешный результат:

{
  "isConfigured": true,
  "isValid": true,
  "isDatabaseReachable": true
}

Все три значения должны быть true: проект указан, его файл подходит, служба может открыть базу. Если есть false, перейдите к разбору ошибки.

Прочитать товары

$products = Invoke-RestMethod -Uri "$baseUrl/api/v1/products?limit=2&offset=0" -Headers $headers
$products | Select-Object id, name | ConvertTo-Json

Команда запрашивает первые 2 товара и показывает их ID и названия. Для проекта с сырами результат выглядит так:

[
  { "id": 1, "name": "Сыр Сливочный 200 г" },
  { "id": 2, "name": "Сыр Гауда 200 г" }
]

Сравните названия с разделом «Товары» в LabelRedo. Совпадение подтверждает, что API читает нужный проект. ID и названия в вашем проекте могут отличаться.

После проверки закройте PowerShell или удалите переменные с токеном:

Remove-Variable token, headers

Проверить API из Linux

Откройте Bash на компьютере со службой. Введите токен из LABELREDO_API_TOKEN файла настроек; он не будет виден при вводе. Не закрывайте этот терминал до конца проверки.

base_url='http://127.0.0.1:5084'
read -r -s -p 'API token: ' token
printf '\n'
curl --fail-with-body -sS -H "Authorization: Bearer $token" "$base_url/api/v1/health"

Ожидаются status: "ok" и service: "LabelRedo API", как в примере выше. Затем проверьте проект:

curl --fail-with-body -sS -H "Authorization: Bearer $token" "$base_url/api/v1/project/status"

В ответе isConfigured, isValid и isDatabaseReachable должны быть true. Прочитайте первые 2 товара:

curl --fail-with-body -sS -H "Authorization: Bearer $token" "$base_url/api/v1/products?limit=2&offset=0"

Ответ содержит массив товаров с id, uniqueId, name, gtin и isUse. Сравните name с названиями в своём проекте. После проверки удалите токен из переменной:

unset token

Если проверка не прошла

Что дальше

Перейдите к чтению данных через API, чтобы получить ID макетов, принтеров и заданий. Для подготовки файла команд без отправки на принтер используйте создание файла через API. Общие правила авторизации, задач и повторных запросов собраны в справочнике API.