Устаревшее API: код ошибки 410
Ошибка 410 «Устаревшее API» приходит от Честного знака, когда программа вызывает отключённый метод. Что сделать и как перевести обмен на True API.
Сообщение «Устаревшее API» с кодом 410 приходит не от сайта и не от браузера. Его отдаёт система маркировки «Честный знак», когда программа вызывает метод, который уже отключили. В ответе обычно есть и сам код, и имя метода:
{
"code": 410,
"error_message": "Устаревшее API",
"method": "POST /api/v3/facade/cis/cis_list"
}
410 здесь значит, что адрес закрыт постоянно. Повтор того же запроса результат не изменит: метод снят с поддержки, а не «временно недоступен».
Где это всплывает
Чаще всего ошибка появляется в 1С: при проверке кодов маркировки, эмиссии, приёмке или другом обмене с ГИС МТ. В тексте метода встречается старый фасадный адрес, например POST /api/v3/facade/cis/cis_list или POST /api/v4/facade/cis/cis_list. Тот же ответ бывает и у других снятых методов: смотрите поле method, оно называет конкретный вызов.
Оператор маркировки заранее предупреждал, что фасадный метод устарел и снят с поддержки, а заменой служит True API. На промышленном контуре markirovka.crpt.ru старый вызов больше не выполняется.
Что сделать
- Сохраните полный текст ошибки. Нужны код, фраза «Устаревшее API» и строка method. По ней видно, какой именно адрес ещё вызывает программа.
- Если в адресе есть
/facade/, обмен до сих пор ходит в старый интерфейс. Его заменяют методы True API: получение информации о кодах по спискуPOST /api/v3/true-api/cises/infoи краткий списокPOST /api/v3/true-api/cises/short/list. Описание лежит в разделе «Помощь» личного кабинета ГИС МТ, документ True API. - Сначала обновите конфигурацию 1С и подсистему обмена с маркировкой до релиза, где эти методы уже стоят. Для типовой базы это безопаснее ручной правки: обновление меняет не только адрес, но и формат запроса.
- Новый адрес нельзя подставить в старый вызов как есть.
cises/infoждёт POST и JSON в теле. Если оставить прежний GET, вместо 410 придёт 405: метод по адресу есть, а тип запроса не тот. - Отдельно проверьте токен и контур. Код 401 означает, что сессия True API истекла, это уже не «устаревшее API». Запрос должен идти на тот контур, где заведена компания: промышленный markirovka.crpt.ru или демонстрационный. Чужой хост отвечает ошибкой даже при верном методе.
- Если в method другой путь, не список кодов, замену берите из актуальной документации True API для этого метода. Старый адрес из ошибки в новый контур не копируют.
- После правки повторите ту же операцию, на которой обмен остановился: проверка кода, эмиссия или приёмка. Успех — это ответ с данными по коду, а не новый код 410.
Чем поможем
Найдём в обмене вызов, из-за которого приходит 410, и переведём его на актуальный метод True API. Проверим, что операция в 1С снова получает данные по кодам, а не ответ «Устаревшее API». Если после смены адреса всплывёт 401 или 405, разберём токен, тип запроса и контур.
Описать задачу можно через онлайн-заявку.