API Московский транспорт (transport.mos.ru)

Документация по работе с API Московский транспорт (transport.mos.ru)

Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.
Отправьте запрос HTTP POST на URL нашего API: https://api-cloud.ru/api/transportMos.php с персональным ключом API и параметрами.
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON

Базовая цена запроса: 0.6 руб.

История изменений/обновлений

type (тип)	Описание	Параметры в запросе
	В одном запросе возможно отправить только 1 тип
pass	Проверить пропуск для грузового транспорта • Вывод данных по пропускам	Обязательные Поиск по серии и номеру пропуска licenseSeries - Серия пропуска Разрешено: буквы кириллицы Маска: ББ, БА, МБ, МК licenseNumber - Номер пропуска Разрешено: цифры token - персональный ключ API Поиск по гос. номеру regNumber - Регистрационный номер транспортного средства Разрешено: кириллица, латиница, цифры, знаки "-" token - персональный ключ API Дополнительные onlyActual=1 - фильтр по признаку "Действующий пропуск" Фильтры применимые с дополнительными (только 1 фильтр из списка) dayannual=1 - в результате только "Дневной Годовой" пропуски nightannual=1 - в результате только "Ночной Годовой" пропуски dayonetime=1 - в результате только "Дневной Разовый" пропуски nightonetime=1 - в результате только "Ночной Разовый" пропуски
rnis	Проверка регистрации ТС в РНИС • ТС зарегистрировано в системе • Телематика передается/не передается • Время/дата передачи телематики	Обязательные regNum - Регистрационный номер ТС Разрешено: латиница, кириллица, цифры, знаки "-" token - персональный ключ API

Обратите внимание, что скорость загрузки результата зависит напрямую от ресурса источника
При подсчете количества запросов будут приняты к учету только те запросы, которы вернули "status": 200 и "status": 404, т.е. получили результат.

Максимальное количество попыток соединения 3 раза. Если в результате этих попыток ресурс не вернет ответа, то API CLOUD вернет ответ {"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}

Примеры запросов

Проверка пропуска по серии и номеру

Пример запроса HTTP GET на URL нашего API

https://api-cloud.ru/api/transportMos.php?type=pass&licenseSeries=ББ&licenseNumber=0832578&token=53ba1b7a55abbB014aa97eff3a522079

{
  "status": 200, // Статус ответа
  // Массив с найденными результатами
  "list": [
    {
      "number": "ББ 0832578", // Серия и номер пропуска
      "grz": "В144МЕ178", // Регистрационный номер ТС
      "startdate": "11.02.2022", // Действителен с
      "validitydate": "17.01.2023", // Действителен по
      "allowedzona": "СК", // Зона ограничения
      "passstatus": "Выдан", // Статус
      "tip": "Годовой", // Тип пропуска
      "typepassvalidityperiod": "Дневной" // Тип пропуска
    }
  ],
  // Выбранные фильтры в результате
  "filters": [
    "onlyActual": 1, // Активность фильтра onlyActual (Вывод только Действующих пропусков)
    "dayannual": 1, // Активность фильтра только "Дневной Годовой"
    "nightannual": 0, Активность фильтра только "Ночной Годовой"
    "dayonetime": 0, Активность фильтра только "Дневной Разовый"
    "nightonetime": 0 Активность фильтра только "Ночной Разовый"
  ],
  // Информация о запросе
  "inquiry": {
    "price": 0,
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 0.6,
    "attempts": 2
  }
}

Проверка пропуска по регистрационному номеру

Пример запроса HTTP GET на URL нашего API

https://api-cloud.ru/api/transportMos.php?type=pass&regNumber=В144МЕ178&token=53ba1b7a55abbB014aa97eff3a522079

{
  "status": 200, // Статус ответа
  "onlyActual": 0, // Активность фильтра onlyActual (Вывод только Действующих пропусков)
  // Массив с пропусками
  "list": [
    {
      "number": "ББ 0802868",
      "grz": "В144МЕ178",
      "startdate": "11.02.2022",
      "validitydate": "29.08.2017 23:59",
      "allowedzona": "МКАД",
      "passstatus": "Выдан",
      "tip": "Годовой", // Тип пропуска
      "typepassvalidityperiod": "Дневной"
    },
    {
      "number": "ББ 0832578",
      "grz": "В144МЕ178",
      "startdate": "13.10.2017 00:00",
      "validitydate": "17.01.2023",
      "allowedzona": "СК",
      "passstatus": "Выдан",
      "tip": "Годовой", // Тип пропуска
      "typepassvalidityperiod": "Дневной"
    }
  ],
  "inquiry": {
    "price": 0.6,
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": null,
    "attempts": 2
  }
}

Пример ответа, когда пропуска не найдены

{"status":200,"count":0,"message":"Пропуска по указанным параметрам не найдены"}

Возможные безрезультативные ответы

// Проблемы с ответом от ресурса источника
{"status":404,"error":1,"message":"Повторите запрос"}

Проверка регистрации ТС в РНИС

Пример запроса HTTP GET на URL нашего API

https://api-cloud.ru/api/transportMos.php?type=rnis&regNum=Е145ТН76&token=53ba1b7a55abbB014aa97eff3a522079

{
"status":200,
"num":1, // Найдено
"vehicleExists":true, // Зарегистрировано
"lastMark":"2022-01-22T19:17:39+03:00", // Дата/время передачи телематики
"isOnline":true, // Телематика передается true/false
"inquiry":{
"price":0.6,
"balance": 100462.11, // Баланс после текущего запроса
"speed":7,
"attempts":1
}
}

Пример ответа, когда ТС не зарегистрировано в РНИС

{
  "status":200,
  "num":0,
  "message":"ТС не зарегистрировано в системе РНИС",
  "inquiry":
  {
    "price":0.6,
    "balance": 100462.11, // Баланс после текущего запроса
    "speed":13,
    "attempts":1
  }
}

История изменений API Московский транспорт

дата	что изменилось
15.03.2024	Добавлена маска для обработки корректности серии пропуска (licenseSeries). Разрешены значения: ББ, БА, МБ, МК Если переданное значение ей не соответствует, то вернется ошибка: {"error":"334","message":"SERIES_INCORRECT_MASK"}
31.10.2023	Метод "pass", добавили возможность проверки иностранных регистрационных знаков.
09.08.2023	Тип запороса pass: В "list" переименован ключ с "ГРЗ" на "grz"
09.08.2023	Тип запороса pass: В "list" переименован ключ с "ГРЗ" на "grz"
09.08.2023	Тип запороса pass: В "list" переименован ключ с "ГРЗ" на "grz"
09.08.2023	В "list" переименован ключ с "ГРЗ" на "grz"
16.05.2023	В типе запроса pass добавили фильтры вывода в результате: dayannual=1 - в результате только "Дневной Годовой" пропуски nightannual=1 - в результате только "Ночной Годовой" пропуски dayonetime=1 - в результате только "Дневной Разовый" пропуски nightonetime=1 - в результате только "Ночной Разовый" пропуски Передавать можно только 1 параметр фильтра, при передаче нескольких параметров возникнет ошибка "PARAMETER_FILTER_CONFLICT"
08.04.2023	1. Оптимизировали скорость обработки по типу запроса "pass" 2. Выполнена перенастройка под источник.
20.03.2023	Метод запроса pass: Пофиксили ошибку "Повторите запрос"
13.03.2023	По методу запроса "pass" добавили возможность вывода в результате только действующих пропусков. Необходимо передать свойство onlyActual=1 вместе с запросом.
01.03.2023	Для метода pass исправили ошибку, при которой нельзя было запросить информацию по конкретному пропуску.
16.02.2023	Исправлены мелкие баги в работе, которые приводили к высокой нагрузке на сервис.
03.12.2022	Починили работу метода pass. Работает в штатном режиме.
21.11.2022	Тип запроса (pass) потерпел некоторые изменения, которые потребуют за собой небольшие правки в вашем коде. 1. Чтобы проверить пропуска по гос. номеру, то теперь не нужно передавать свойство licenseSeries, передаем только свойство regNumber 2. В результате поиска пропал ключ datecancellation, вместо него появился ключ tip - тип пропуска (Годовой,Разовый) 3. В ключах startdate и validitydate пропало время, только дата. Документация обновлена согласно изменениям.
24.10.2022	По типу запроса rnis добавили латиницу в исключения при проверке свойства regNum. Необходимо для отправки запроса с иностранными номерами.
23.10.2022	В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса.
27.09.2022	Починили type->rnis
21.04.2022	1. Добавлен заголовок "Content-type: application/json; charset=utf-8" 2. Запросы теперь отправляются не GET, а POST.
16.03.2022	Обновили алгоритмы type->pass и type->rnis
22.01.2022	Новый тип запроса - rnis Проверка регистрации ТС в РНИС

Возможные коды ошибок

код (error)	Описание ошибки (message)
888	ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы
766	MISSING_MANDATORY_PARAMETER Отсутствуют обязательные параметры
602	TOKEN_NO_ACCESS Нет доступа к запрашиваему методу запроса
505	MISSING_REQ_REGNUM_STS_PARAM Ошибка в переданных параметрах regnum или sts
504	TOKEN_LOCKED_IN_THE_SYSTEM Переданный токен заблокирован службой качества / автоматической системой
503	TOKEN_NOT_REGISTERED_IN_THE_SYSTEM Переданный токен не зарегистрирован в системе
502	MISSING_REQUIRED_TOKEN_PARAMETER Отсутствует параметр token
500	MISSING_REQUIRED_TYPE_PARAMETER Отсутствует параметр type
499	WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа.
498	TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс.
460	NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры
456	MAX_LIMIT Превышено количество одновременных соединений (потоки)
404	TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже.
334	SERIES_INCORRECT_MASK Параметр серии пропуска не соответствует маске
333	PARAMETER_FILTER_CONFLICT Конфликт переданных параметров фильтрации. Возможно передать только 1 фильтр
123	IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК
111	PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно.
015	DATE_ERROR Ошибка значения переданной даты
005	TEST_TIME_OFF Закончился период тестирования
001	API_SUSPENDED Работа этого API временно приостановлена. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже.

Пример ответа с ошибкой

{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}

Документация по работе с API Московский транспорт (transport.mos.ru)

Проверка пропуска по серии и номеру

Проверка пропуска по регистрационному номеру

Пример ответа, когда пропуска не найдены

Возможные безрезультативные ответы

Проверка регистрации ТС в РНИС

Пример ответа, когда ТС не зарегистрировано в РНИС

История изменений API Московский транспорт

Возможные коды ошибок

• API ГИБДД (Государственная инспекция безопасности дорожного движения)

• API Федеральная Таможенная Служба (ФТС)

• API VIN Декодер (Расшифровка данных VIN номера)

• API РСА (Российский Союз Автостраховщиков)

• API ЕАИСТО (Единая Автоматизированная Информационная система технического осмотра)

• API ФССП (Федеральная Служба Судебных Приставов)

• API Отзывные компании

• API Проверка ТС по базе такси

• API Фотографии транспортных средств

• API Каталог фотографий авто

• API Оценка стоимости автомобиля

• API МВД (Министерство Внутренних дел)

• API ФРИ (Федеральный реестр инвалидов)

• API Федеральная налоговая служба

• API Московский транспорт (transport.mos.ru)

• API Федеральный ресурс (Банкротства)

• API Росреестр

• API Bidcars (История автомобилей из США с аукционов Copart и IAAI)

• API Электронный ПТС

• API Номерограм

• API Скриншот сайта

• API Росфинмониторинг

• API Конвертер VIN<->Рег.номер

• API API ras.arbitr (Решения арбитражных судов)

• API kad.arbitr (Картотека арбитражных дел)

• API Реестр залогов