API Поиска транспорта
API Поиска транспорта позволяет найти свободные машины по указанным параметрам и контакты перевозчиков. Останется только связаться с ними и договориться о перевозке.
Подходит вам, если:
- ищете перевозчика для уже размещенного на ATI.SU груза;
- ищете перевозчика самостоятельно, без размещения груза на ATI.SU.
Подробнее об информации, возвращаемой API, смотрите в описании методов.
Методы
Для проверки корректности интеграции с данным API, можно указать необязательный параметр, позволяющий получить демо-данные:
demo
- Флаг демо-режима (Boolean)
При указании этого параметра сервером будет возвращен тестовый набор данных с тем же контрактом ответа, что и в полноценном API.
Доступ к API
Доступ к API платный, предоставляется по запросу.
По вопросам подключения обращайтесь к Александру Вильде.
Email: sas@ati.su
Телефон: + 7-812-602-01-04 доб.108
Поиск транспорта по фильтру post /v1.0/trucks/search/by-filter
Номер страницы
Количество машин на странице. [10, 20, 30, 40, 50, 100]
Фильтр
Когда доступна машина
Когда доступна машина.
- today-plus - С сегодняшнего дня
- today - Только сегодня
- tomorrow - Только завтра
- today-tomorrow - Сегодня и завтра
- today-two-days - Сегодня + 2 дня
- today-three-days - Сегодня + 3 дня
- today-four-days - Сегодня + 4 дня
- today-five-days - Сегодня + 5 дня
- manual - Вручную
С какого числа доступна машина. Используется только при значении date_option "manual"
До какого числа доступна машина. Используется только при значении date_option "manual"
Откуда машина
Id гео-пункта. Используется для страны, региона или города
Тип гео-пункта
- 0 - Страна
- 1 - Регион
- 2 - Город
- 5 - Список
Только по точным. Учитывается только при type = 2
Id гео-списка. Используется только при type = 5
Радиус, в котором ищутся города. Учитывается только при type = 2
Куда машина
Id гео-пункта. Используется для страны, региона или города
Тип гео-пункта
- 0 - Страна
- 1 - Регион
- 2 - Город
- 5 - Список
Только по точным. Учитывается только при type = 2
Id гео-списка. Используется только при type = 5
Радиус, в котором ищутся города. Учитывается только при type = 2
Габариты
Длина
Минимальное значение
Максимальное значение
Ширина
Минимальное значение
Максимальное значение
Высота
Минимальное значение
Максимальное значение
Подходят ли машины с неуказанными габаритами
Вес
Минимальное значение
Максимальное значение
Объем
Минимальное значение
Максимальное значение
Дополнительные параметры
Возможность догруза
- 0 - Догруз или отдельной машиной
- 1 - Только догруз
- 2 - Только отдельной машиной
Гидролифт
Коники
Не показывать постоянные
Тип опасности груза (ADR). [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 100, 101]
Показывать машины только со ставкой
Промежуток времени, когда машина добавлена в систему
- all - Когда угодно
- hour - За последний час
- three-hours - За 3 часа
- today - Сегодня
- three-days - За 3 дня
- week - За неделю
Битовая сумма id типов кузова, значения из словаря вариантов типов кузова
Битовая сумма id типов загрузки, значения из словаря вариантов типов загрузки
Параметр фирм
Код пользователя
Минимальный рейтинг пользователя
Откуда фирма
Id гео-пункта
Тип гео-пункта
- 0 - Страна
- 1 - Регион
- 2 - Город
Id списка фирм
- 0 - Сортировка по дате добавления
- 1 - Сортировка по весу
Оплата
Максимальная ставка
- 0 - Не указано
- 1 - Рубль за километр
- 2 - Рубль
- 3 - Тысяч рублей
- 4 - Рубль в час
Наличными
С НДС
Без НДС
curl 'https://api.ati.su/v1.0/trucks/search/by-filter' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"page":0,"items_per_page":0,"filter":{"dates":{"date_option":"string","date_from":"1970-01-01T00:00:00.000Z","date_to":"1970-01-01T00:00:00.000Z"},"from":{"id":0,"type":0,"exact_only":false,"list_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","radius":0},"to":{"id":0,"type":0,"exact_only":false,"list_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","radius":0},"dimensions":{"length":{"min":0.5,"max":0.5},"width":{"min":0.5,"max":0.5},"height":{"min":0.5,"max":0.5},"include_empty":false},"weight":{"min":0.5,"max":0.5},"volume":{"min":0.5,"max":0.5},"extra_params":{"dogruz_type":0,"hydrolysis":false,"conics":false,"do_not_show_regular":false,"adr_type":0},"with_rate":false,"change_date":"string","truck_type":0,"loading_type":0,"firm":{"ati_id":"string","firm_rating":0,"firm_geo":{"id":0,"type":0},"firm_list":"3fa85f64-5717-4562-b3fc-2c963f66afa6","firm_list_exclusive":false},"sorting_type":0,"payment":{"rate_value":0.5,"rate_type":0,"cash":false,"with_nds":false,"without_nds":false}}}'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/v1.0/trucks/search/by-filter", "{""page"":0,""items_per_page"":0,""filter"":{""dates"":{""date_option"":""string"",""date_from"":""1970-01-01T00:00:00.000Z"",""date_to"":""1970-01-01T00:00:00.000Z""},""from"":{""id"":0,""type"":0,""exact_only"":false,""list_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""radius"":0},""to"":{""id"":0,""type"":0,""exact_only"":false,""list_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""radius"":0},""dimensions"":{""length"":{""min"":0.5,""max"":0.5},""width"":{""min"":0.5,""max"":0.5},""height"":{""min"":0.5,""max"":0.5},""include_empty"":false},""weight"":{""min"":0.5,""max"":0.5},""volume"":{""min"":0.5,""max"":0.5},""extra_params"":{""dogruz_type"":0,""hydrolysis"":false,""conics"":false,""do_not_show_regular"":false,""adr_type"":0},""with_rate"":false,""change_date"":""string"",""truck_type"":0,""loading_type"":0,""firm"":{""ati_id"":""string"",""firm_rating"":0,""firm_geo"":{""id"":0,""type"":0},""firm_list"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""firm_list_exclusive"":false},""sorting_type"":0,""payment"":{""rate_value"":0.5,""rate_type"":0,""cash"":false,""with_nds"":false,""without_nds"":false}}}");
200 Success
Результат поиска
Найдено машин
Скрыто машин, подходящих под фильтр
Аккаунты для найденных машин. Ключ - код фирмы в ATI.SU
Код фирмы в ATI.SU
Название фирмы
Полное имя фирмы: Брэнд (Название фирмы, ОПФ)
Брэнд фирмы
Идентификатор формы собственности
Право собственности фирмы
Идентификатор профиля деятельности фирмы
Профиль деятельности фирмы
Сумма претензий к данной фирме в рублях
Количество претензий к данной фирме
Количество упоминаний о данной фирме на форуме "Недобросовестные партнеры"
Количество фирм, которые написали о данной фирме на форуме Недобросовестных партнеров
Количество рекомендаций к фирме
Количество рекомендаций к фирме
Партнер ATI.SU
Член общ. движения Круглый Стол
Id города откуда фирма
Паспорт фирмы
За подтверждение аккаунта
За срок "существования" фирмы
Свидетельство ведения фирмой текущей хозяйственной деятельности
Балл по решению общественного движения пользователей ATI.SU "Круглый стол"
Балл за имеющиеся Претензии к пользователю
За проф. деятельность в ATI.SU
По решению администрации ATI.SU
Балл за клонов участника системы
По данным Единых Государственных Реестров Юридических Лиц и ИП
Юридическое лицо зарегистрировано по адресу массовой регистрации
Учредитель юридического лица является учредителем множества других юридических лиц
За давность регистрации в АвтоТрансИнфо
Отрицательных баллов
Общее количество звезд
- 0 - Серые звёзды
- 1 - Зелёные звёзды
- 2 - Жёлтые звёзды
- 3 - Красные звёзды
- 4 - Партнёр ATI.SU
- 5 - Сотрудник ATI.SU
- 6 - Гос. орган
- 7 - Член общ. движения Круглый Стол
Описание статуса
Контакты фирмы
Идентификатор контакта
Имя контакта
Телефон контакта
Телефонный брэнд
Регион, в котором зарегистрирован телефонный номер
Есть ли Email у контакта
Icq контакта
Мобильный телефон контакта
Мобильный брэнд
Регион, в котором зарегистрирован мобильный телефонный номер
Скайп контакта
Факс контакта
Мобильный оператор
Id города контакта
Пользовательские списки
Фирма состоит в Партнерском списке пользователя
Фирма состоит в Нейтральном списке пользователя
Фирма состоит в Черном списке пользователя
Принадлежность фирмы к спискам пользователя, выполняющего поиск
Эмоджи группы списков
Общее кол-во списков в группе
Вложенная структура со списками группы
Название списка
Id списка
Эмоджи списка
- 0 - Нейтральный список
- 1 - Белый список
- 2 - Чёрный список
Принадлежность к дефолтным спискам
Комментарий к фирме
Поисковая выдача. Список машин
Код пользователя
Id машины
Время добавления данных машины в формате UTC
Дата последнего изменения данных машины в формате UTC
Идентификатор первого выбранного контакта
Идентификатор второго выбранного контакта, если не выбрано, то null
Подразделение машины
Примечание к машине
Дата, начиная с которой машина актуальна, UTC
Дата, после которой машина не актуальна, в формате UTC
- 0 - не выбрано
- 1 - ежедневно
- 5 - 2 раза в неделю
- 10 - еженедельно
- 20 - ежемесячно
- 40 - часто
- 50 - по согласию
- 100 - по рабочим дням
- 0 - готов к загрузке
- 1 - с Х по У
- 2 - постоянно
Озвученная ставка
Валюта озвученной ставки
Характеристики машины
Идентификатор кузова
- 0 - Не указано
- 1 - Грузовик
- 2 - Полуприцеп
- 4 - Прицеп
Битовая сумма id типов загрузки, значения из словаря вариантов типов загрузки
Максимальный вес перевозки в тоннах
Объем кузова в кубических метрах
Длина кузова в метрах
Ширина кузова в метрах
Высота кузова в метрах
Длина прицепа в метрах
Ширина прицепа в метрах
Высота прицепа в метрах
Параметр, определяющий, имеется ли в кузове гидролифт
Параметр, определяющий, возможен ли догруз
Определяет, присутствуют ли коники
Параметр, определяющий, имеются ли у машины документы TIR
Параметр, определяющий, имеются ли у машины документы EKMT
Параметр, определяющий уровни опасности грузов, которые можно провозить на данной машине.
Загрузка
Id города загрузки
Радиус, в котором машина может быть загружена, в км
Расстояние от пункта указанного в поиске до пункта указанного в машине
Список пунктов разгрузки
Флаг главного пункта разгрузки
Видимость пункта в выдаче (зависит от фильтра)
Ставка наличными
Ставка с НДС
Ставка без НДС
Валюта ставки
Тип гео-пункта
- 0 - Страна
- 1 - Регион
- 2 - Город
Id гео-пункта
Радиус относительно пункта, в котором возможна разгрузка. Только при point_type = 2 (город)
Расстояние до пункта "откуда" из фильтра. Заполняется, если point_type = 2 и искали в город.
Оплата
Оплата на карту
Торг
Флаг видимости контактов для незарегистрированных пользователей
Комментарии к машинам
Id комментария
Сообщение
Id контакта, оставившего сообщение
Имя контакта, оставившего сообщение
Время добавления комментария
Словарь отзывов на машину. Ключ - id машины
Список встречных предложений
Идентификатор машины
Время добавления встречного предложения
Время последнего редактирования встречного предложения
Ставка наличными
Валюта для ставки наличными
Ставка с НДС
Валюта ставки с НДС
Ставка без НДС
Валюта ставки без НДС
Примечание
Процент предоплаты
Постоплата (количество банковских дней)
Город загрузки
Город разгрузки
Вес
Объём
Дата
Оплата на выгрузке
Догруз
Информация о фирме
Код пользователя в ATI.SU
Идентификатор контакта
Информация о контакте
Имя контакта
Телефон контакта
Мобильный телефон контакта
Город контакта
Icq контакта
Skype контакта
Факс контакта
Email контакта
Название фирмы
Балл фирмы
- 0 - Серые звёзды
- 1 - Зелёные звёзды
- 2 - Жёлтые звёзды
- 3 - Красные звёзды
- 4 - Партнёр ATI.SU
- 5 - Сотрудник ATI.SU
- 6 - Гос. орган
- 7 - Член общ. движения Круглый Стол
Список жалоб "Машины нет"
Идентификатор машины
Время добавления жалобы
Информация о фирме
Код пользователя в ATI.SU
Идентификатор контакта
Информация о контакте
Имя контакта
Телефон контакта
Мобильный телефон контакта
Город контакта
Icq контакта
Skype контакта
Факс контакта
Email контакта
Название фирмы
Балл фирмы
- 0 - Серые звёзды
- 1 - Зелёные звёзды
- 2 - Жёлтые звёзды
- 3 - Красные звёзды
- 4 - Партнёр ATI.SU
- 5 - Сотрудник ATI.SU
- 6 - Гос. орган
- 7 - Член общ. движения Круглый Стол
Список жалоб на машину
Идентификатор машины
Время добавления жалобы
Время последнего редактирования жалобы
Текст жалобы
Информация о фирме, оставившей жалобу
Код пользователя в ATI.SU
Идентификатор контакта
Информация о контакте
Имя контакта
Телефон контакта
Мобильный телефон контакта
Город контакта
Icq контакта
Skype контакта
Факс контакта
Email контакта
Название фирмы
Балл фирмы
- 0 - Серые звёзды
- 1 - Зелёные звёзды
- 2 - Жёлтые звёзды
- 3 - Красные звёзды
- 4 - Партнёр ATI.SU
- 5 - Сотрудник ATI.SU
- 6 - Гос. орган
- 7 - Член общ. движения Круглый Стол