openapi: 3.0.2
info:
  title: API проверки спецразрешений КТГ (Росдормониторинг)
  description: Сервис позволяет получить информацию о специальном разрешении на движение по автомобильным дорогам тяжеловесного и (или) крупногабаритного транспортного средства (КТГ) из Федерального реестра спецразрешений. Источник данных — ФКУ "Росдормониторинг", urm.safe-route.ru. Все запросы требуют указания ключа доступа (`key`).
  version: 1.0.0
servers:
  - url: https://parser-api.com/parser/ktg_permit_api
paths:
  /:
    get:
      summary: Проверка специального разрешения КТГ
      description: Получает информацию о специальном разрешении по его номеру и государственному регистрационному номеру ТС.
      parameters:
        - name: key
          in: query
          required: true
          schema:
            type: string
          description: Ключ доступа к сервису.
        - name: licenseNumber
          in: query
          required: true
          schema:
            type: string
          description: Номер специального разрешения.
          example: Р050-00100-00/00012345
        - name: regNumber
          in: query
          required: true
          schema:
            type: string
          description: Государственный регистрационный номер транспортного средства.
          example: А123ВС750
      responses:
        '200':
          description: Успешная обработка запроса.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: integer
                    description: Флаг успешности выполнения запроса. При получении 0 сделайте повторный запрос сразу же или через несколько минут.
                    example: 1
                  record:
                    type: object
                    nullable: true
                    description: Данные о специальном разрешении. Отсутствует, если разрешение не найдено.
                    properties:
                      licenseNumber:
                        type: string
                        description: Номер специального разрешения.
                        example: Р050-00100-00/00012345
                      applicationNumber:
                        type: string
                        description: Номер заявления.
                        example: РДС1234567
                      issueDate:
                        type: string
                        description: Дата и время выдачи разрешения (МСК), формат YYYY-MM-DD HH:MM.
                        example: "2026-04-15 10:30"
                      transportationType:
                        type: string
                        description: Вид перевозки (Международная, Внутрироссийская и т.п.).
                        example: Внутрироссийская
                      maxSpeed:
                        type: number
                        description: Предполагаемая максимальная скорость движения ТС, км/ч.
                        example: 70.0
                      tripsCount:
                        type: string
                        description: Количество разрешённых поездок ("неограниченно" либо число строкой).
                        example: неограниченно
                      startDate:
                        type: string
                        description: Дата начала срока выполнения поездок, формат YYYY-MM-DD.
                        example: "2026-04-15"
                      endDate:
                        type: string
                        description: Дата окончания срока выполнения поездок, формат YYYY-MM-DD.
                        example: "2026-09-15"
                      escortType:
                        type: string
                        nullable: true
                        description: Вид сопровождения (null, если не требуется).
                        example: null
                      issuer:
                        type: string
                        description: Наименование уполномоченного органа, выдавшего разрешение.
                        example: Федеральное казенное учреждение "Центр мониторинга безопасной эксплуатации автомобильных дорог Федерального дорожного агентства"
                      vehicles:
                        type: array
                        description: Транспортные средства в составе автопоезда.
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                              description: Тип ТС.
                              example: Седельный тягач
                            mark:
                              type: string
                              description: Марка ТС.
                              example: SCANIA
                            model:
                              type: string
                              description: Модель ТС.
                              example: R450
                            regNumber:
                              type: string
                              description: Государственный регистрационный номер.
                              example: А123ВС750
                            vin:
                              type: string
                              description: Идентификационный номер (VIN).
                              example: XLER4X20000123456
                            country:
                              type: string
                              description: Страна регистрации.
                              example: Российская Федерация
                      client:
                        type: object
                        description: Сведения о заявителе.
                        properties:
                          name:
                            type: string
                            description: Полное наименование заявителя (ФИО или название организации).
                            example: Иванов Иван Иванович
                          address:
                            type: string
                            description: Адрес заявителя.
                            example: "123456, г. Москва, ул. Ленина, д. 1, кв. 10"
                          phone:
                            type: string
                            description: Контактный телефон.
                            example: "+74951234567"
                      cargos:
                        type: array
                        description: Характеристики перевозимого груза.
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                              description: Наименование груза.
                              example: Строительные конструкции
                            length:
                              type: number
                              description: Длина груза, м.
                              example: 18.0
                            width:
                              type: number
                              description: Ширина груза, м.
                              example: 2.8
                            height:
                              type: number
                              description: Высота груза, м.
                              example: 3.5
                            weight:
                              type: number
                              description: Масса груза, т.
                              example: 22.5
                      params:
                        type: object
                        description: Параметры автопоезда.
                        properties:
                          emptyMass:
                            type: number
                            description: Масса автопоезда без груза, т.
                            example: 18.5
                          fullMass:
                            type: number
                            description: Масса автопоезда с грузом, т.
                            example: 41.0
                          length:
                            type: number
                            description: Длина автопоезда, м.
                            example: 22.0
                          width:
                            type: number
                            description: Ширина автопоезда, м.
                            example: 2.8
                          height:
                            type: number
                            description: Высота автопоезда, м.
                            example: 4.0
                          frontOverhang:
                            type: number
                            description: Передний свес, м.
                            example: 1.2
                          rearOverhang:
                            type: number
                            description: Задний свес, м.
                            example: 2.5
                          minRadius:
                            type: number
                            description: Минимальный радиус поворота с грузом, м.
                            example: 11.0
                      axles:
                        type: array
                        description: Информация об осях ТС (автопоезда).
                        items:
                          type: object
                          properties:
                            pos:
                              type: integer
                              description: Порядковый номер оси.
                              example: 1
                            distanceToNext:
                              type: number
                              description: Расстояние до следующей оси, м.
                              example: 3.5
                            load:
                              type: number
                              description: Нагрузка на ось, т.
                              example: 8.0
                            wheels:
                              type: integer
                              description: Количество колёс на оси.
                              example: 2
                            slope:
                              type: integer
                              description: Скатность колёс.
                              example: 1
                            airSuspension:
                              type: boolean
                              description: Наличие пневматической подвески.
                              example: false
                      route:
                        type: array
                        description: Участки маршрута транспортного средства.
                        items:
                          type: object
                          properties:
                            totalLength:
                              type: number
                              description: Накопленная протяжённость маршрута с начала, км.
                              example: 45.0
                            length:
                              type: number
                              description: Протяжённость участка, км.
                              example: 45.0
                            name:
                              type: string
                              description: Наименование участка.
                              example: Московская область, А-104
                      specialConditions:
                        type: array
                        description: Особые условия движения.
                        items:
                          type: object
                          properties:
                            owner:
                              type: string
                              description: Владелец автомобильной дороги.
                              example: ФКУ Упрдор "Москва - Санкт-Петербург"
                            road:
                              type: string
                              description: Наименование автомобильной дороги или сооружения.
                              example: а/д М-10 "Россия" Москва - Тверь - Великий Новгород - Санкт-Петербург
                            range:
                              type: string
                              description: Диапазон километров участка.
                              example: 0 - 50+000
                            condition:
                              type: string
                              description: Текст особого условия.
                              example: На участках проведения ремонтных работ движение осуществлять с соблюдением требований временных технических средств организации дорожного движения.
                            period:
                              type: string
                              description: Период действия условия.
                              example: Постоянно
                      signature:
                        type: object
                        description: Сведения об электронной подписи уполномоченного органа.
                        properties:
                          thumbprint:
                            type: string
                            description: Отпечаток сертификата.
                            example: ABCDEF1234567890ABCDEF1234567890ABCDEF12
                          issuedTo:
                            type: string
                            description: Владелец сертификата.
                            example: ФЕДЕРАЛЬНОЕ КАЗЕННОЕ УЧРЕЖДЕНИЕ "ЦЕНТР МОНИТОРИНГА БЕЗОПАСНОЙ ЭКСПЛУАТАЦИИ АВТОМОБИЛЬНЫХ ДОРОГ ФЕДЕРАЛЬНОГО ДОРОЖНОГО АГЕНТСТВА"
                          validFrom:
                            type: string
                            description: Дата начала действия сертификата, формат YYYY-MM-DD.
                            example: "2025-01-01"
                          validTo:
                            type: string
                            description: Дата окончания действия сертификата, формат YYYY-MM-DD.
                            example: "2027-12-31"
              examples:
                permitFound:
                  summary: Информация по разрешению получена
                  value:
                    success: 1
                    record:
                      licenseNumber: Р050-00100-00/00012345
                      applicationNumber: РДС1234567
                      issueDate: "2026-04-15 10:30"
                      transportationType: Внутрироссийская
                      maxSpeed: 70.0
                      tripsCount: неограниченно
                      startDate: "2026-04-15"
                      endDate: "2026-09-15"
                      escortType: null
                      issuer: Федеральное казенное учреждение "Центр мониторинга безопасной эксплуатации автомобильных дорог Федерального дорожного агентства"
                      vehicles:
                        - type: Седельный тягач
                          mark: SCANIA
                          model: R450
                          regNumber: А123ВС750
                          vin: XLER4X20000123456
                          country: Российская Федерация
                      client:
                        name: Иванов Иван Иванович
                        address: "123456, г. Москва, ул. Ленина, д. 1, кв. 10"
                        phone: "+74951234567"
                      cargos:
                        - name: Строительные конструкции
                          length: 18.0
                          width: 2.8
                          height: 3.5
                          weight: 22.5
                      signature:
                        thumbprint: ABCDEF1234567890ABCDEF1234567890ABCDEF12
                        issuedTo: ФЕДЕРАЛЬНОЕ КАЗЕННОЕ УЧРЕЖДЕНИЕ "ЦЕНТР МОНИТОРИНГА БЕЗОПАСНОЙ ЭКСПЛУАТАЦИИ АВТОМОБИЛЬНЫХ ДОРОГ ФЕДЕРАЛЬНОГО ДОРОЖНОГО АГЕНТСТВА"
                        validFrom: "2025-01-01"
                        validTo: "2027-12-31"
                permitNotFound:
                  summary: Разрешение не найдено
                  value:
                    success: 1
                temporaryFailure:
                  summary: Временный сбой источника — повторите запрос
                  value:
                    success: 0
        '400':
          description: Ошибка валидации запроса.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Подробное описание ошибки.
                    example: licenseNumber and regNumber are required
                  error_code:
                    type: integer
                    description: Код ошибки.
                    example: 40001
        '403':
          description: Ограничение доступа к сервису.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Подробное описание ошибки.
                    example: Invalid access key
                  error_code:
                    type: integer
                    description: Код ошибки.
                    example: 40301
              examples:
                invalidKey:
                  value:
                    error: Invalid access key
                    error_code: 40301
                expiredSubscription:
                  value:
                    error: The subscription period has expired
                    error_code: 40302
                invalidIP:
                  value:
                    error: Invalid IP
                    error_code: 40303
                dayLimitExceeded:
                  value:
                    error: Day limit of requests exceeded
                    error_code: 40304
                monthLimitExceeded:
                  value:
                    error: Month limit of requests exceeded
                    error_code: 40305
