API-клиенты

API-клиенты нужны для серверных подключений внешних учетных, складских, кассовых, WMS/ERP и внутренних IT-систем к данным Checkmark.

Администратор создает клиента, выбирает права доступа и получает client_id и client_secret. Секрет показывается один раз: после закрытия окна его нельзя посмотреть повторно, можно только перевыпустить.

Каждый активный API-клиент занимает один слот в лимите устройств ЛК. Отозванный или истекший клиент слот не занимает.

Что можно делать

• читать адреса, свои ИНН и поставщиков;
• проверять КМ через тот же пайплайн, что использует веб-интерфейс;
• читать таблицы КМ, остатков и кейсов пересорта;
• создавать кейсы пересорта по авторитетной проверке;
• читать статусы печати.

Управление пользователями, тарифами, оплатой, сертификатами и секретами Честного ЗНАКа через внешний API не открывается.

Безопасность

Для каждого клиента выбирайте минимальный набор прав. Если секрет мог попасть третьим лицам, перевыпустите секрет или отзовите клиента.

Внешняя система получает короткий Bearer-токен через /api/integrations/oauth/token и затем вызывает только /api/integrations/v1/*.