## Документация API проверки спецразрешений КТГ (Росдормониторинг) Сервис позволяет получить информацию о специальном разрешении на движение по автомобильным дорогам тяжеловесного и (или) крупногабаритного транспортного средства (КТГ) из Федерального реестра спецразрешений. Источник данных — ФКУ «Росдормониторинг», `urm.safe-route.ru`. ### Проверка специального разрешения Для проверки спецразрешения используйте следующий запрос: ``` https://service.api-assist.com/parser/ktg_permit_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&licenseNumber=НОМЕР_РАЗРЕШЕНИЯ®Number=ГОСНОМЕР_ТС ``` **Параметры запроса:** - **key** — ключ доступа к сервису (обязательный). - **licenseNumber** — номер специального разрешения (обязательный), например `Р050-00100-00/00012345`. - **regNumber** — государственный регистрационный номер ТС (обязательный), например `А123ВС750`. Оба параметра обязательны — источник проверяет соответствие номера разрешения и госномера ТС. **Пример запроса:** ``` https://service.api-assist.com/parser/ktg_permit_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&licenseNumber=Р050-00100-00/00012345®Number=А123ВС750 ``` **Пример ответа на запрос:** Ответ возвращается в формате JSON. При успешной проверке поле `record` содержит информацию о разрешении: ```json { "success": 1, // Флаг успешности выполнения запроса. При получении 0 сделайте повторный запрос сразу же или через несколько минут. "record": { // Информация о разрешении. Отсутствует, если разрешение по указанным параметрам не найдено. "licenseNumber": "Р050-00100-00/00012345", // Номер специального разрешения "applicationNumber": "РДС1234567", // Номер заявления "issueDate": "2026-04-15 10:30", // Дата и время выдачи разрешения (МСК), формат YYYY-MM-DD HH:MM "transportationType": "Внутрироссийская", // Вид перевозки (Международная, Внутрироссийская и т.п.) "maxSpeed": 70.0, // Предполагаемая максимальная скорость движения, км/ч "tripsCount": "неограниченно", // Количество разрешённых поездок ("неограниченно" либо число строкой) "startDate": "2026-04-15", // Дата начала срока выполнения поездок, формат YYYY-MM-DD "endDate": "2026-09-15", // Дата окончания срока выполнения поездок, формат YYYY-MM-DD "escortType": null, // Вид сопровождения (null, если не требуется) "issuer": "Федеральное казенное учреждение \"Центр мониторинга безопасной эксплуатации автомобильных дорог Федерального дорожного агентства\"", // Наименование уполномоченного органа, выдавшего разрешение "vehicles": [ // Транспортные средства в составе автопоезда { "type": "Седельный тягач", // Тип ТС (Седельный тягач, Полуприцеп, Грузовой автомобиль, Прицеп, Автобус и др.) "mark": "SCANIA", // Марка ТС "model": "R450", // Модель ТС "regNumber": "А123ВС750", // Государственный регистрационный номер ТС "vin": "XLER4X20000123456", // Идентификационный номер (VIN) "country": "Российская Федерация" // Страна регистрации ТС }, { "type": "Полуприцеп", "mark": "SCHMITZ", "model": "SKO 24", "regNumber": "АА123450", "vin": "WSM00000000654321", "country": "Российская Федерация" } ], "client": { // Сведения о заявителе "name": "Иванов Иван Иванович", // Полное наименование заявителя (ФИО или название организации) "address": "123456, г. Москва, ул. Ленина, д. 1, кв. 10", // Адрес заявителя "phone": "+74951234567" // Контактный телефон }, "cargos": [ // Характеристики перевозимого груза { "name": "Строительные конструкции", // Наименование груза "length": 18.0, // Длина груза, м "width": 2.8, // Ширина груза, м "height": 3.5, // Высота груза, м "weight": 22.5 // Масса груза, т } ], "params": { // Параметры автопоезда "emptyMass": 18.5, // Масса автопоезда без груза, т "fullMass": 41.0, // Масса автопоезда с грузом, т "length": 22.0, // Длина автопоезда, м "width": 2.8, // Ширина автопоезда, м "height": 4.0, // Высота автопоезда, м "frontOverhang": 1.2, // Передний свес, м "rearOverhang": 2.5, // Задний свес, м "minRadius": 11.0 // Минимальный радиус поворота с грузом, м }, "axles": [ // Информация об осях ТС (автопоезда) { "pos": 1, "distanceToNext": 3.5, "load": 8.0, "wheels": 2, "slope": 1, "airSuspension": false }, { "pos": 2, "distanceToNext": 8.0, "load": 10.5, "wheels": 4, "slope": 2, "airSuspension": true }, { "pos": 3, "distanceToNext": 1.35, "load": 7.5, "wheels": 2, "slope": 2, "airSuspension": true }, { "pos": 4, "distanceToNext": 0.0, "load": 7.5, "wheels": 2, "slope": 2, "airSuspension": true } // pos — порядковый номер оси // distanceToNext — расстояние до следующей оси, м // load — нагрузка на ось, т // wheels — количество колёс на оси // slope — скатность колёс // airSuspension — наличие пневматической подвески ], "route": [ // Участки маршрута транспортного средства { "totalLength": 45.0, "length": 45.0, "name": "Московская область, А-104" }, { "totalLength": 132.0, "length": 87.0, "name": "Московская область, М-9" } // totalLength — накопленная протяжённость маршрута с начала, км // length — протяжённость участка, км // name — наименование участка ], "specialConditions": [ // Особые условия движения { "owner": "ФКУ Упрдор \"Москва - Санкт-Петербург\"", // Владелец автомобильной дороги "road": "а/д М-10 \"Россия\" Москва - Тверь - Великий Новгород - Санкт-Петербург", // Наименование автомобильной дороги или сооружения "range": "0 - 50+000", // Диапазон километров участка "condition": "На участках проведения ремонтных работ движение осуществлять с соблюдением требований временных технических средств организации дорожного движения.", // Текст особого условия "period": "Постоянно" // Период действия условия } ], "signature": { // Сведения об электронной подписи уполномоченного органа "thumbprint": "ABCDEF1234567890ABCDEF1234567890ABCDEF12", // Отпечаток сертификата "issuedTo": "ФЕДЕРАЛЬНОЕ КАЗЕННОЕ УЧРЕЖДЕНИЕ \"ЦЕНТР МОНИТОРИНГА БЕЗОПАСНОЙ ЭКСПЛУАТАЦИИ АВТОМОБИЛЬНЫХ ДОРОГ ФЕДЕРАЛЬНОГО ДОРОЖНОГО АГЕНТСТВА\"", // Владелец сертификата "validFrom": "2025-01-01", // Дата начала действия сертификата, формат YYYY-MM-DD "validTo": "2027-12-31" // Дата окончания действия сертификата, формат YYYY-MM-DD } } } ``` ### Интерпретация ответа и обработка ошибок **Общие рекомендации:** - Если поле `success` заполнено и `success = 1` — перед вами успешный ответ, с которым можно работать. Только такие запросы учитываются в статистике и расходуют оплаченный лимит. - Иначе, если поле `error` заполнено — запрос требует вашего внимания. Текст ошибки рекомендуется сохранить или отправить для дальнейшего анализа. - Иначе, если поле `error` не заполнено — это ошибка, связанная со стабильностью источника. В таком случае мы рекомендуем игнорировать ответ и повторить запрос. #### 1. Код ответа — 200 - Поле `success = 1` — удалось получить информацию от источника. Такие и только такие запросы можно запускать в дальнейшую обработку. - При наличии `record` — разрешение найдено. - При отсутствии `record` — разрешение по указанным параметрам не найдено. - Поле `success = 0` — не удалось получить информацию от источника. Запрос не будет учтён в статистике. Необходимо повторить запрос. #### 2. Код ответа — 403 Выдаётся сервисом в случае невозможности обработки запроса из-за ограничения доступа: закончилась подписка, превышен лимит и так далее. Причины ошибок отражены в поле `error` ответа. Ниже приведён список возможных ошибок с их описанием и кодами: - **Invalid access key** `error_code = 40301` Указанный ключ доступа недействителен или отсутствует. - **The subscription period has expired** `error_code = 40302` Доступ к сервису истёк, требуется продление. - **Invalid IP** `error_code = 40303` Запрос выполнен с IP-адреса, который не разрешён для доступа. - **Day limit of requests exceeded** `error_code = 40304` Достигнут оплаченный лимит запросов на день. - **Month limit of requests exceeded** `error_code = 40305` Достигнут оплаченный лимит запросов на месяц. **Пример ответа:** ```json { "error": "Invalid access key", "error_code": 40301 } ``` #### 3. Код ответа — 400 Выдаётся сервисом в случае невозможности обработки запроса из-за ошибки валидации, неверного или отсутствующего значения какого-либо поля. Поле `error_code` всегда равно `40001`, подробности доступны в поле `error`. **Пример ответа:** ```json { "error": "licenseNumber and regNumber are required", "error_code": 40001 } ```