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

Средние ставки

API позволяет получить средние ставки из сервиса «Средние ставки», а также разброс и динамику средних ставок за выбранный период по самым популярным направлениям в России.

Информация актуальна для полностью загруженных автомобилей 20 т, 82 м³. При расчёте учтены ставки участников ATI.SU, а также параметры реальных сделок на Бирже.

Как рассчитываются средние ставки

  • Ежедневно сотни тысяч участников ATI.SU выставляют грузы и проводят сделки.
  • Мы аккумулируем и обрабатываем данные участников.
  • Предоставляем текущие ставки и их динамику.

Вы получаете актуальные средние ставки, видите, как они менялись за выбранный промежуток времени, насколько велик разброс цен по направлению. А также вы видите количество грузов на ATI.SU по выбранному направлению в выбранный период.

Подробнее об API Средних ставок и методах получения данных

Ограничения при работе с API

Время ответа зависит от того, какой объём данных вы запросили.

Примеры времени ответа, для разных вариантов запроса:

  • за 1 день — 150 мс;
  • за полгода по дням — 400 мс;
  • за год по месяцам — 15 с;
  • за 2 года по неделям — 40 с.

Доступ к API

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

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

Методы

Доступные направления для средних ставок

 
Возвращает список всех доступных направлений и доступные типы кузова для направления
get
/priceline/license/v1/all_directions
CURL 1C
CURL
Копировать

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

                
Пример ответа Ответ
200 Successful Response
Развернуть все Свернуть все
Пример Модель
{...}
"AllDirections":[...]
{...}
"FromCityId":0,
"FromCity":"string",
"ToCityId":0,
"ToCity":"string",
"FromRegionId":0,
"FromRegion":"string",
"ToRegionId":0,
"ToRegion":"string",
"CarTypes":[...],
"string"
],
"RoundTrips":{...}
"0":[...]
"string"
]
}
}
]
}
{...}
}
422 Validation Error
Развернуть все Свернуть все
Пример Модель
{...}
"detail":[...]
{...}
"loc":[...],
0
],
"msg":"string",
"type":"string"
}
]
}
{...}
}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Запрос средних ставок

 
Метод получения средних цен
post
/priceline/license/v1/average_prices
Развернуть все Свернуть все
{...}
CarType: string

Тип кузова.

  • ref - рефрижераторы.
  • close - закрытые. Значение по умолчанию.
  • open - открытые.
  • tent - тентованный.
  • tral - трал.
  • docker - контейнер.
DateFrom: date

Начало периода. Формат ISO-8601. Если интересует только одна дата, то передавать ее здесь. По умолчанию - последний день, за который есть данные.

DateTo: date

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

Frequency: string

Дискретность выдачи данных.

  • day - для каждого дня будут выданы данные. Значение по умолчанию. Опция day доступна только в том случае, если общий временной период составляет меньше 6 месяцев.
  • week - будут выданы усредненные данные по неделе.
  • month- будут выданы усредненные данные по месяцу.
WithNds: boolean

Учитывать ли НДС в цене.

  • false - не учитывать. Значение по умолчанию.
  • true - учитывать.
RoundTrip: boolean

Параметр позволяет получить цену кругорейса, то есть ставку для маршрута «туда и обратно».

  • false - для прямого рейса. Значение по умолчанию.
  • true - для кругового рейса (если доступен).
}
CURL 1C
CURL
Копировать

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

                
Пример ответа Ответ
200 Successful Response
Развернуть все Свернуть все
Пример Модель
{...}
"Data":[...],
{...}
"DateFrom":"2022-03-01",
"DateTo":"2022-03-02",
"Prices":{...},
"UpperPrice":30,
"BottomPrice":10,
"AveragePrice":20
},
"PricesInRub":{...},
"UpperPrice":30,
"BottomPrice":10,
"AveragePrice":20
},
"LoadsCount":121
}
],
"Distance":750,
"WithNDS":false
}
{...}
Distance*: integer

Расстояние маршрута в километрах

WithNDS*: boolean

Являются ли данные ставки ставками с учётом НДС

}
404 Not Found
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string",
"details":{}
}
{...}
error*: string

Основное тело ошибки с описанием

reason*: string

Тип ошибки если имеется

details*:{}

Какие-либо дополнительные детали ошибки

}
422 Unprocessable Entity
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string",
"details":{}
}
{...}
error*: string

Основное тело ошибки с описанием

reason*: string

Тип ошибки если имеется

details*:{}

Какие-либо дополнительные детали ошибки

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