Skip to content
Для ИИ NEW Мои токены Поддержка
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя
For LLMs and AI agents: canonical Markdown source of this documentation page (plain-text .md — fetch this URL to use the page content in tools and RAG). For LLMs and AI agents: developers documentation index in llms.txt format — ordered list of key documentation URLs for the developers section.

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

Описание

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

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

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

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

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

Доступ к API

Подключить API можно как и любую другую лицензию на странице оплаты.

Если у вас остались вопросы — напишите в техническую поддержку на api@ati.su.

Методы

Методы с тегом Есть демо можно проверить на корректность интеграции с данными API:
передайте в параметрах запроса demo=true

Подробности во вкладке «Модель и примеры», отправить запрос можно во вкладке «Консоль».

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

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

Находит активных перевозчиков по направлению и возвращает количество их актуальных машин. Поиск выполняется между двумя локациями: странами, регионами или городами. Укажите период активности, локации from и to; при необходимости добавьте параметры ТС. Требуются авторизация Bearer и доступ к API поиска активных перевозчиков. При demo=true после проверки параметров возвращаются демонстрационные данные без проверки платного доступа. Есть демо Метод можно проверить на тестовых данных: передайте в параметрах запроса demo=true
post /v2/dstats/active_firms/search
Параметры
Параметр Тип Расположение Описание
demo boolean query
Вернуть демонстрационные данные. По умолчанию false. Пример: false
Запрос
Модель
{...}

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

begin_date*: date-time

Начало периода активности в формате ISO-8601. Обязательно; дата не должна быть позже текущей.

end_date: date-time (nullable)

Конец периода активности в формате ISO-8601. Если не задан, используется текущее время UTC.

truck_type: int64 (nullable)

Битовая маска типов кузова. Получите словарь кузовов через GET /gw/marshak/v1/cartypes?attributeFieldFormat=2 и используйте числовое значение атрибута mask, а не ID элемента. Для нескольких типов объедините маски побитовым OR; тип выбран, если (truck_type & mask) == mask. Например, для масок 1 и 4 результат 1 | 4 = 5. Если поле не задано, фильтра по типу кузова нет.

trucks_date_from: date-time (nullable)

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

trucks_date_to: date-time (nullable)

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

volume: int32 (nullable)

Объём в кубических метрах, больше нуля. Не задавайте одновременно с границами truck_volume.

weight: int32 (nullable)

Вес в тоннах, больше нуля. Не задавайте одновременно с границами truck_weight.

}
Пример запроса
curl 'https://api.ati.su/v2/dstats/active_firms/search' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '{"begin_date":"2024-01-15T00:00:00Z","end_date":"2024-01-31T23:59:59Z","from":{"id":1,"type":2},"rating_coefficients":{"actual_trucks":0.6,"analytics_trucks":2,"profile":{"0":0.45,"1":1},"real_trucker":0.6},"to":{"id":2,"type":2},"truck_type":1,"trucks_date_from":"2024-01-15T00:00:00Z","trucks_date_to":"2024-01-31T23:59:59Z","volume":82,"weight":20}'
Ответ
200 Активные перевозчики
Модель
{...}

Результат поиска активных перевозчиков.

is_demo*: boolean

Признак демо-данных; true при запросе с demo=true.

ok*: boolean

Признак успешного выполнения запроса.

}
Пример
{...}
"is_demo":false,
"ok":true,
"result":[...]
{...}
"actual_trucks_count":2,
"id":"123456",
"inn":"7701234567",
"search_count":12,
"sum_count":15,
"trucks_count":3
}
]
}
400 Ошибка в запросе
Модель
{...}

Описание ошибки выполнения запроса.

details*: {missing-type-info}

Дополнительные сведения, зависящие от ошибки. Пустой объект, если сведений нет.

error_code*: string

Код ошибки.

error_list*:[{}]

Вложенные ошибки. Пустой массив, если вложенных ошибок нет.

reason*: string

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

}
Пример
{...}
"details":"?",
"error_code":"input_validation_error",
"error_list":[...],
{}
],
"reason":"Ошибка валидации параметров запроса"
}
403 У вас нет доступа к данному API
Модель
{...}

Описание ошибки выполнения запроса.

details*: {missing-type-info}

Дополнительные сведения, зависящие от ошибки. Пустой объект, если сведений нет.

error_code*: string

Код ошибки.

error_list*:[{}]

Вложенные ошибки. Пустой массив, если вложенных ошибок нет.

reason*: string

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

}
Пример
{...}
"details":"?",
"error_code":"input_validation_error",
"error_list":[...],
{}
],
"reason":"Ошибка валидации параметров запроса"
}