API для транспортных информационных систем

Вы заинтересованы в обмене информацией о рынке грузоперевозок? Тогда давайте сотрудничать!

Ниже описан предлагаемый протокол обмена информацией.

Способ добавления информации в Автодиспетчер.Ру

Добавление производится по протоколу HTTP 1.0, методом POST. Данные передаются в кодировке UTF-8 на русском языке.

Для отладки и тестирования передавайте параметр is_test=1, такие тестовые объявления не будут отображаться на сайте и не будут мешать другим пользователям.

URL-ы:

  • для работы с грузами: http://www.avtodispetcher.ru/import/infosystem/consignor.php
  • для работы с транспортом: http://www.avtodispetcher.ru/import/infosystem/truck.php

Возвращаемые HTTP-коды:

  • 200 - объявление успешно добавлено. В теле ответа содержится идентификатор добавленного объявления.
  • 401 - объявление НЕ добавлено. Указан не правильный логин или пароль.
  • 500 - объявление НЕ добавлено. В теле ответа содержится описание причины.

Добавление груза

Жирным текстом выделены поля, обязательные для заполнения.

поле запросазначение
actionДействие. Для добавления значением является "add".
place_fromОткуда. Название населенного пункта. Например, "Ростов-на-Дону".
region_fromОткуда - название региона, без сокращений. Например, "Ростовская область".
country_fromОткуда - название страны, без сокращений. Например, "Россия".
place_toКуда. Название населенного пункта. Например, "Краснодар".
region_toКуда - название региона, без сокращений. Например, "Краснодарский край".
country_toКуда - название страны, без сокращений. Например, "Украина".
transport_typesТипы транспортных средств, подходящие для перевозки. Значением поля является одно или несколько (разделитель - запятая) значений из списка: тент, рефрижератор, бортовой, будка, термобудка, контейнеровоз, платформа, лесовоз/трубовоз, панелевоз, автовоз, самосвал, цистерна.
date_ready_startНачальная дата готовности груза к загрузке в формате YYYY-mm-dd.
date_ready_endКонечная дата готовности груза к загрузке в формате YYYY-mm-dd.
is_ready"1", если груз постоянно готов к загрузке, иначе "0". Если груз постоянно готов к загрузке, то поля date_ready_start и date_ready_end игнорируются.
is_consent_passing"1", если груз можно доставить попутным, частично загруженным транспортом, иначе "0".
good_natureХарактер груза. Например "Стройматериалы".
good_volumeОбъём груза в кубометрах. Например "11.5".
good_massМасса груза в тоннах. Например "4.5".
pallet_countОбъём груза в евро паллетах. Например "5".
has_tir"1", если необходим TIR.
is_agreed_price"1", если ставка за перевозку груза является договорной. Для договорной ставки игнорируются поля price_value и price_currency.
price_valueРазмер фиксированной ставки. Например "18000".
price_currencyВалюта фиксированной ставки. Возможные значения: ruble, dollar, euro, grivna,
contact_personКонтактное лицо
contact_orgНазвание организации
contact_phone1Телефон № 1. В международном формате: с кодом страны, кодом города. Например, "79181234567".
contact_phone2Телефон № 2. В международном формате: с кодом страны, кодом города.
contact_faxФакс. В международном формате: с кодом страны, кодом города.
noteПримечание.
emailКонтактный email грузовладельца.
passwordВаш партнерский пароль в Автодиспетчер.Ру.

Редактирование размещенного ранее груза

Могут указываться только те поля, значения которых должны быть изменены.

поле запросазначение
actionДействие. Для редактирования значением является "edit".
idидентификатор объявления в Автодиспетчер.Ру, полученный на шаге добавления обяъвления
contact_phone1Телефон № 1
contact_phone2Телефон № 2
passwordВаш партнерский пароль в Автодиспетчер.Ру.

Удаление размещенного ранее груза

поле запросазначение
actionДействие. Для удаления значением является "delete".
idидентификатор объявления в Автодиспетчер.Ру, полученный на шаге добавления обяъвления
passwordВаш партнерский пароль в Автодиспетчер.Ру.

Добавление транспорта

Жирным текстом выделены поля, обязательные для заполнения.

поле запросазначение
actionДействие. Для добавления значением является "add".
place_fromОткуда. Название населенного пункта. Например, "Ростов-на-Дону".
region_fromОткуда - название региона, без сокращений. Например, "Ростовская область".
country_fromОткуда - название страны, без сокращений. Например, "Россия".
place_toКуда - название населенного пункта. Например, "Краснодар".
region_toКуда - название региона, без сокращений. Например, "Краснодарский край".
country_toКуда - название страны, без сокращений. Например, "Украина".
intermediate_listПеречень промежуточных пунктов следования. Например, "Ростов-на-Дону, Краснодар, Туапсе".
is_only_full_load"1", если Вы согласны только на полную загрузку транспорта.
is_only_partly_load"1", если Вы согласны только на частичную загрузку транспорта.
date_ready_startНачальная дата готовности транспорта к загрузке в формате YYYY-mm-dd.
date_ready_endКонечная дата готовности транспорта к загрузке в формате YYYY-mm-dd.
is_ready"1", если транспорт постоянно готов к загрузке, иначе "0". Если транспорт постоянно готов к загрузке, то поля date_ready_start и date_ready_end игнорируются.
transport_typeТип транспортного средства. Возможные значения: грузовик, сцепка, седельник
transport_brandМарка транспортного средства. Например, "Камаз".
transport_reg_numberРегистрационный номер транспортного средства. Например, "а123бс".
transport_suspensionТип подвески транспортного средства. Возможные значения: рессорная, пневматическая.
transport_body_typeТип исполнения грузового помещения. Возможные значения: тент, рефрижератор, бортовой, будка, термобудка, контейнеровоз, платформа, лесовоз/трубовоз, панелевоз, автовоз, самосвал, цистерна.
transport_is_low_carriage"1", если транспорт - низкорамник.
transport_load_typeТип загрузки транспортного средства. Возможные значения: задняя + боковая, задняя + боковая + верхняя, задняя + верхняя, задняя.
transport_volumeОбъём грузового помещения в кубометрах. Например, "5".
transport_pallet_countОбъём грузового помещения в евро паллетах. Например, "7".
transport_lengthДлина грузового помещения в метрах. Например, "12.5".
transport_widthШирина грузового помещения в метрах. Например, "3.5".
transport_heightВысота грузового помещения в метрах. Например, "2.5".
transport_carrying_capacityГрузоподъёмность транспорта в тоннах. Например, "3".
has_tir"1", если имеется TIR.
has_dangerous_order"1", если имеется разрешение на перевозку опасных грузов.
trailer_body_typeТип исполнения прицепа. Возможные значения: тент, рефрижератор, бортовой, будка, термобудка, контейнеровоз, платформа, лесовоз/трубовоз, панелевоз, автовоз, самосвал, цистерна.
trailer_suspensionТип подвески прицепа. Возможные значения: рессорная, пневматическая.
trailer_is_low_carriage"1", если прицеп - низкорамник.
trailer_load_typeТип загрузки прицепа. Возможные значения: задняя + боковая, задняя + боковая + верхняя, задняя + верхняя, задняя.
trailer_volumeОбъём грузового помещения прицепа в кубометрах. Например, "5".
trailer_pallet_countОбъём грузового помещения прицепа в евро паллетах. Например, "7".
trailer_lengthДлина грузового помещения прицепа в метрах. Например, "5.5".
trailer_widthШирина грузового помещения прицепа в метрах. Например, "3.5".
trailer_heightВысота грузового помещения прицепа в метрах. Например, "2.5".
trailer_carrying_capacityГрузоподъёмность прицепа в тоннах. Например, "2".
is_agreed_price"1", если ставка за перевозку является договорной. Для договорной ставки игнорируются поля price_value и price_currency.
price_valueРазмер фиксированной ставки. Например "18000".
price_currencyВалюта фиксированной ставки. Возможные значения: ruble, dollar, euro, grivna,
contact_personКонтактное лицо
contact_orgНазвание организации
contact_phone1Телефон № 1. В международном формате: с кодом страны, кодом города. Например, "79181234567".
contact_phone2Телефон № 2. В международном формате: с кодом страны, кодом города.
contact_faxФакс. В международном формате: с кодом страны, кодом города.
noteПримечание.
emailКонтактный email грузоперевозчика.
passwordВаш партнерский пароль в Автодиспетчер.Ру.

Редактирование размещенного ранее транспорта

Могут указываться только те поля, значения которых должны быть изменены.

поле запросазначение
actionДействие. Для редактирования значением является "edit".
idидентификатор объявления в Автодиспетчер.Ру, полученный на шаге добавления обяъвления
contact_phone1Телефон № 1
contact_phone2Телефон № 2
passwordВаш партнерский пароль в Автодиспетчер.Ру

Удаление размещенного ранее транспорта

поле запросазначение
actionДействие. Для удаления значением является "delete".
idидентификатор объявления в Автодиспетчер.Ру, полученный на шаге добавления обяъвления
passwordВаш партнерский пароль в Автодиспетчер.Ру
Личный кабинет
Войти в кабинет
У Вас есть вопросы, проблемы, пожелания?
Пишите нам: