К кабинету Маркета могут одновременно обращаться учётная система, аналитический сервис и собственная автоматизация продавца. При ошибке в журнале важно быстро установить, какое приложение выполнило запрос. Для этого документация Маркета предлагает подписывать интеграции названием и версией.

Как обозначается приложение

В исходящих запросах используется заголовок X-Market-Integration с названием интеграции и, при наличии, её версией через косую черту. Для ответов на API-уведомления предусмотрены поля name и version. Название должно состоять из ASCII-символов и содержать не более ста знаков.

В кабинете эти сведения отображаются в журнале запросов; доступен фильтр по интеграции. В данном случае «подпись» означает обозначение программы для диагностики. Это не электронная подпись документа и не замена токена авторизации.

Договориться об именах заранее

Редакционная рекомендация — назначить каждому приложению устойчивое понятное название. Например, отдельно учитывать модуль учётной системы и внутреннюю выгрузку отчётов. Если все процессы представляются как «client», журнал не поможет различить их после сбоя.

Версия полезна, когда ошибка появилась после обновления. Укажите, какое обозначение соответствует установленной сборке, и сохраняйте дату её запуска. Не включайте в название токены, персональные данные сотрудников или другую информацию, которая не нужна для определения приложения.

Что проверить при подключении

Попросите интегратора выполнить согласованный запрос чтения и найдите его в журнале Маркета по времени и названию. Убедитесь, что отображается ожидаемая версия и запрос относится к нужному кабинету. Затем повторите для второго приложения, чтобы проверить различимость, а не только наличие какого-либо заголовка.

Если система принимает уведомления, отдельно проверьте её обозначение в ответах. Настройка исходящих запросов и обработчика уведомлений может находиться в разных частях приложения; исправление одной не подтверждает, что обновлена другая.

Как использовать при разборе ошибки

Сохраните время, магазин, метод, результат и название интеграции. Передайте исполнителю небольшой воспроизводимый пример, а не весь журнал с лишними данными. Сопоставьте сбой с последним обновлением и другими процессами, которые могли обращаться к тем же товарам.

Наличие имени помогает найти ответственного, но не доказывает причину. Ошибка может возникнуть из-за параметров, прав или состояния данных. После исправления проверьте исходный сценарий и убедитесь, что регулярная задача тоже использует обновлённую версию. Тогда журнал станет рабочим средством диагностики, а не просто списком обращений.