Диагностика области доступа для API-операции
Версия 2.7
Сопоставление операции и права
Сначала определите, какую операцию выполняет приложение. Чтение статусов использует `shipments:read`, создание отправления требует `shipments:write`. Посмотрите, какой ключ сервер подставил для конкретного процесса, по имени настройки или идентификатору записи в хранилище. Роль оператора в кабинете и область серверного ключа проверяются отдельно. Возможность создать отправление вручную не устанавливает область ключа интеграции.
Что означает AUTH-403
Код AUTH-403 означает, что ключ не имеет нужной области доступа. Владелец проверяет область ключа в «Настройки → Интеграции». Сверьте, какое действие привело к ошибке, и проверьте, не попало ли задание на создание в клиент чтения. Сохраните корреляцию с локальным заказом. После изменения настроек повторите штатную проверку разрешённой операции и посмотрите результат в кабинете.
Проверка доставки заголовка
Передавайте ключ в заголовке Authorization как Bearer из серверного кода. В настройках reverse proxy и клиентской библиотеки проверьте, что заголовок присутствует на исходящем запросе. Диагностировать его наличие можно по булевому признаку или локальному имени конфигурации. Полное значение ключа не требуется. Если ошибка появляется только в одном процессе, сравните источник конфигурации и время его последнего обновления.
Отладка по группам запросов
Сравните один успешный запрос и один отказ с той же средой и организацией. Если падает только создание, проверьте область записи. Если операции не удаются лишь в одной среде, сверьте ключ и адрес подключения. Если проблема возникает после ротации, установите, какие экземпляры уже получили новый секрет. Такой порядок сокращает число одновременных изменений и помогает определить причину.
Что передать владельцу или поддержке
Укажите тип операции, код, время с часовым поясом, организацию и идентификатор запроса, если он записан. Для диагностики безопасно приложить обезличенный фрагмент конфигурации с названием поля и признаком его заполнения. Уберите значения Authorization и другие секреты. Отдельно отметьте, работает ли тот же тип запроса в тестовом кабинете и воспроизводится ли проблема на разных складах.
Одинаковый отказ на всех экземплярах
Сверьте последнее изменение прав и время вступления в силу конфигурации приложения. Если каждый экземпляр использует один источник настроек, проверьте его первым. Проведите повторную проверку после изменения на одном контролируемом экземпляре, чтобы не запускать параллельно весь объём накопленных записей до выяснения причины.
Отказ в одном задании
Если рядом с отказом есть успешные операции, сравните назначение ключа по типу задачи и выбранную организацию. Сначала проверьте логи выбора профиля, затем сопоставьте действие с нужной областью. Исправление маршрутизации задания часто безопаснее расширения прав всех клиентов. После проверки верните в работу только затронутое задание с сохранением исходной операции.