API ТС ПИоТ: запросы, проверка кода и интеграция кассового ПО
Практическое объяснение API ТС ПИоТ для разработчиков: сценарий проверки, статусы, ошибки и безопасная интеграция.
Задача API
API нужен кассовому ПО и интеграторам для передачи данных на проверку кода маркировки и получения результата. Конкретные endpoint, авторизация и формат запроса определяются текущей документацией решения.
Типовой сценарий
- Кассовое ПО получает код маркировки.
- Отправляет запрос на локальный компонент/сервис.
- ТС ПИоТ выполняет проверку по своей схеме взаимодействия.
- Касса получает результат и формирует чек по правилам конкретного сценария.
Обработка ошибок
Нельзя считать HTTP 200 безусловным успехом: некоторые сервисы возвращают асинхронный статус обработки. Поэтому интеграция должна уметь повторить запрос по UUID/идентификатору результата, когда это предусмотрено API.
Безопасность
Токены и пароли нельзя встраивать в открытый клиентский JavaScript или публиковать в Git. Храните секреты в защищённой конфигурации и ограничивайте доступ к локальному API.
Связанные материалы
Полный справочник ТС ПИоТ · совместимость · ошибки · файлы и драйверы.