API Ставок в похожих грузах

API предоставляет средние значения ставок участников ATI.SU для похожих грузов.

Учитываются параметры груза: направление перевозки, тип груза и кузова, объём, вес, тип упаковки, количество мест и класс опасности, а также тип оплаты: с НДС, без НДС и наличными.

Как получить доступ к API

Чтобы получить доступ к API – подключите лицензию «API Средних ставок» на странице оплаты.

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

Методы

Получение ставок в похожих грузах

Ставки в похожих грузах - API

post /webapi/bazaar/v1/price_prediction_api

Модель и примеры

Запрос

Модель

{...}

from_city*: integer

>=1

Значение поля id в структуре city из словаря ATI.SU

to_city*: integer

>=1

Значение поля id в структуре city из словаря ATI.SU

cargo_type: integer

Идентификатор наименования груза. Значение поля Id из словаря грузов ATI.SU

car_type*: integer

>=1

Тип кузова. Значение поля Id из словаря кузовов ATI.SU

volume: number

Объем груза в кубических метрах. Обязательный параметр, если не задан параметр weight.

weight: number

Вес груза в тоннах. Обязательный параметр, если не задан параметр volume.

distance: number

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

adr: integer

>=0 and <= 9

Параметр, определяющий степень опасности груза. Допустимое значение: Null, либо от 0 до 9.

dogruz*: string

Загрузка:

• ftl — отдельной машиной
• dont-care — отдельной машиной или догрузом

pallet_count: integer

Количество упаковок

pack_type_id: integer

ID типа упаковок из словаря типов упаковок ATI.SU

}

Пример запроса

CURL

curl 'https://api.ati.su/webapi/bazaar/v1/price_prediction_api' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"car_type":1,"distance":700,"dogruz":"ftl","from_city":1,"to_city":3611,"volume":0,"weight":15}'

1C

Процедура Выполнить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", "/webapi/bazaar/v1/price_prediction_api", "{""car_type"":1,""distance"":700,""dogruz"":""ftl"",""from_city"":1,""to_city"":3611,""volume"":0,""weight"":15}");

Ответ

200 Successful Response

Модель

{...}

price_with_tax:{...}

Цена с НДС, руб

price*: integer

}

price_without_tax:{...}

Цена без НДС, руб

price*: integer

}

price_with_cash:{...}

Цена наличными, руб

price*: integer

}

is_approximated: boolean

В случае, если параметр true, то у нас недостаточно данных по направлению. Учтены дополнительные данные с похожих направлений.

}

Пример

{...}

"price_with_tax":{...},

"price":0

},

"price_without_tax":{...},

"price":0

},

"price_with_cash":{...},

"price":0

},

"is_approximated":false

}

404 Not Found

Модель

{...}

error_body*: string

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

reason*: string

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

details*:{}

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

}

Пример

{...}

"error_body":"string",

"reason":"string",

"details":{}

}

422 Unprocessable Entity

Модель

{...}

error_body*: string

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

reason*: string

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

details*:{}

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

}

Пример

{...}

"error_body":"string",

"reason":"string",

"details":{}

}

Консоль

Отправить

Параметры

demo true false

{ "car_type": 1, "distance": 700, "dogruz": "ftl", "from_city": 1, "to_city": 3611, "volume": 0, "weight": 15 }