Помощь
Чат для вопросов по API
Мгновенно ответим на ваши вопросы
api@ati.su
Электронная почта техподдержки
Тикетная система
Оставить заявку на отдел
«Консультанты по интеграции (API)»
api.ati.su - заказы, торги, площадки
Наш телеграм-канал
Код в АТИ:
Выход

Поиск активных перевозчиков

API Активных перевозчиков

Описание

Поможет найти наиболее активных и заинтересованных Перевозчиков по заданному направлению.

Подходит вам, если:

  • Хотите найти надежных партнеров для долгосрочного сотрудничества;
  • Находитесь в поиске перевозчиков для нового или непопулярного направления;
  • Не хотите размещать грузы в общем доступе и самостоятельно ищете перевозчиков, которые стабильно работают по нужному направлению.

Воспользовавшись поиском Вы увидите, как часто участники ищут грузы в заданном направлении. А также сколько объявлений о свободных ТС, потенциально интересных вам, они добавляли на сайт за указанный вами период.

Подробнее об информации, возвращаемой API, смотрите в описании методов.

Доступ к API

Доступ к API — платный, предоставляется по запросу.

По вопросам подключения обращайтесь к Александру Вильде: sas@ati.su, + 7-812-602-01-04 доб.108

Методы

Для проверки корректности интеграции с данным API в запросах, описанных ниже, можно указать необязательный параметр, позволяющий получить демо-данные:

  • demo - Флаг демо-режима (Boolean)

При указании этого параметра сервером будет возвращен тестовый набор данных с тем же контрактом ответа, что и в полноценном API.

Метод поиска по направлению

Получение списка самых активных перевозчиков для заданного направления.

 
Получение активных перевозчиков по заданным параметрам
post
/v1.0/dstats/active_firms/search
Развернуть все Свернуть все
{...}
begin_date*: date-time

Дата, от которой ведется поиск активных фирм в формате ISO-8601

truck_type: int64

Маска типа кузова
Значение из словаря кузовов АТИ

volume: int32

Объём в метрах кубических

weight: int32

Вес в тоннах

}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Активные перевозчики
Развернуть все Свернуть все
Пример Модель
{...}
"is_demo":false,
"ok":false,
"result":[...]
{...}
"id":"string",
"inn":"string",
"search_count":0,
"sum_count":0,
"trucks_count":0
}
]
}
{...}
is_demo*: boolean

Это демо-данные?

ok*: boolean

Успешно?

}
400 Ошибка в запросе
Развернуть все Свернуть все
Пример Модель
{...}
"details":"?",
"error_code":"string",
"error_list":[...],
{}
],
"reason":"string"
}
{...}
details*: {missing-type-info}

Детали ошибки

error_code*: string

Код ошибки

error_list*:[{}]

Список вложенных ошибок

reason*: string

Причина ошибки

}
403 У вас нет доступа к данному API
Развернуть все Свернуть все
Пример Модель
{...}
"details":"?",
"error_code":"string",
"error_list":[...],
{}
],
"reason":"string"
}
{...}
details*: {missing-type-info}

Детали ошибки

error_code*: string

Код ошибки

error_list*:[{}]

Список вложенных ошибок

reason*: string

Причина ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...
 
Получение активных перевозчиков по заданным параметрам (только по городам)
Данная версия метода устарела и её поддержка будет прекращена.
Пожалуйста, пользуйтесь актуальной версией API.
post
/v1.0/dstats/active_firms
Развернуть все Свернуть все
{...}
begin_date*: date-time

Дата, от которой ведется поиск активных фирм в формате ISO-8601

city_from*: int32

ID города откуда
Значение из словаря

city_to*: int32

ID города куда
Значение из словаря

truck_type: int64

Маска типа кузова
Значение из словаря кузовов АТИ

volume: int32

Объём в метрах кубических

weight: int32

Вес в тоннах

}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Активные перевозчики
Развернуть все Свернуть все
Пример Модель
{...}
"is_demo":false,
"ok":false,
"result":[...]
{...}
"id":"string",
"inn":"string",
"search_count":0,
"sum_count":0,
"trucks_count":0
}
]
}
{...}
is_demo*: boolean

Это демо-данные?

ok*: boolean

Успешно?

}
400 Ошибка в запросе
Развернуть все Свернуть все
Пример Модель
{...}
"details":"?",
"error_code":"string",
"error_list":[...],
{}
],
"reason":"string"
}
{...}
details*: {missing-type-info}

Детали ошибки

error_code*: string

Код ошибки

error_list*:[{}]

Список вложенных ошибок

reason*: string

Причина ошибки

}
403 У вас нет доступа к данному API
Развернуть все Свернуть все
Пример Модель
{...}
"details":"?",
"error_code":"string",
"error_list":[...],
{}
],
"reason":"string"
}
{...}
details*: {missing-type-info}

Детали ошибки

error_code*: string

Код ошибки

error_list*:[{}]

Список вложенных ошибок

reason*: string

Причина ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Метод поиска по направлению с количеством актуальных машин

Получение списка самых активных перевозчиков и количество их актуальных машин для заданного направления.

 
Получение активных перевозчиков по заданным параметрам
post
/v2/dstats/active_firms/search
Развернуть все Свернуть все
{...}
begin_date*: date-time

Дата, от которой ведется поиск активных фирм в формате ISO-8601

truck_type: int64

Маска типа кузова
Значение из словаря кузовов АТИ

volume: int32

Объём в метрах кубических

weight: int32

Вес в тоннах

trucks_date_from: date-time

Дата, от которой ведется поиск актуальных машин в формате ISO-8601. Если отсутствует в запросе, то используется значение begin_date

trucks_date_to: date-time

Дата, до которой ведется поиск актуальных машин в формате ISO-8601. Должна быть больше даты начала поиска машин. Если отсутствует в запросе, то результат поиска не ограничивается сверху

}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Активные перевозчики
Развернуть все Свернуть все
Пример Модель
{...}
"is_demo":false,
"ok":false,
"result":[...]
{...}
"actual_trucks_count":0,
"id":"string",
"inn":"string",
"search_count":0,
"sum_count":0,
"trucks_count":0
}
]
}
{...}
is_demo*: boolean

Это демо-данные?

ok*: boolean

Успешно?

}
400 Ошибка в запросе
Развернуть все Свернуть все
Пример Модель
{...}
"details":"?",
"error_code":"string",
"error_list":[...],
{}
],
"reason":"string"
}
{...}
details*: {missing-type-info}

Детали ошибки

error_code*: string

Код ошибки

error_list*:[{}]

Список вложенных ошибок

reason*: string

Причина ошибки

}
403 У вас нет доступа к данному API
Развернуть все Свернуть все
Пример Модель
{...}
"details":"?",
"error_code":"string",
"error_list":[...],
{}
],
"reason":"string"
}
{...}
details*: {missing-type-info}

Детали ошибки

error_code*: string

Код ошибки

error_list*:[{}]

Список вложенных ошибок

reason*: string

Причина ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...
 
Получение активных перевозчиков по заданным параметрам (только по городам)
Данная версия метода устарела и её поддержка будет прекращена.
Пожалуйста, пользуйтесь актуальной версией API.
post
/v2/dstats/active_firms
Развернуть все Свернуть все
{...}
begin_date*: date-time

Дата, от которой ведется поиск активных фирм в формате ISO-8601

city_from*: int32

ID города откуда
Значение из словаря

city_to*: int32

ID города куда
Значение из словаря

truck_type: int64

Маска типа кузова
Значение из словаря кузовов АТИ

volume: int32

Объём в метрах кубических

weight: int32

Вес в тоннах

trucks_date_from: date-time

Дата, от которой ведется поиск актуальных машин в формате ISO-8601. Если отсутствует в запросе, то используется значение begin_date

trucks_date_to: date-time

Дата, до которой ведется поиск актуальных машин в формате ISO-8601. Должна быть больше даты начала поиска машин. Если отсутствует в запросе, то результат поиска не ограничивается сверху

}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Активные перевозчики
Развернуть все Свернуть все
Пример Модель
{...}
"is_demo":false,
"ok":false,
"result":[...]
{...}
"actual_trucks_count":0,
"id":"string",
"inn":"string",
"search_count":0,
"sum_count":0,
"trucks_count":0
}
]
}
{...}
is_demo*: boolean

Это демо-данные?

ok*: boolean

Успешно?

}
400 Ошибка в запросе
Развернуть все Свернуть все
Пример Модель
{...}
"details":"?",
"error_code":"string",
"error_list":[...],
{}
],
"reason":"string"
}
{...}
details*: {missing-type-info}

Детали ошибки

error_code*: string

Код ошибки

error_list*:[{}]

Список вложенных ошибок

reason*: string

Причина ошибки

}
403 У вас нет доступа к данному API
Развернуть все Свернуть все
Пример Модель
{...}
"details":"?",
"error_code":"string",
"error_list":[...],
{}
],
"reason":"string"
}
{...}
details*: {missing-type-info}

Детали ошибки

error_code*: string

Код ошибки

error_list*:[{}]

Список вложенных ошибок

reason*: string

Причина ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...