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

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

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

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

Чтобы получить доступ к API – подключите лицензию «API Средних ставок» [на странице оплаты](https://billing.ati.su/addinvoice?option=2&services=569&priceperiod=1).

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

## Методы

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

<a id="post-v1-price_prediction_api"></a>

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

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/webapi/bazaar/v1/price_prediction_api?demo=false' \
  -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
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/paid-api/price_prediction.openapi.json)

**Описание полей запроса**
- `car_type` — Тип кузова. Значение поля `Id` из [словаря кузовов ATI.SU](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `distance` — Расстояние маршрута в километрах
- `dogruz` — Загрузка: - `ftl` — отдельной машиной - `dont-care` — отдельной машиной или догрузом
- `from_city` — Значение поля `id` в структуре `city` из [словаря ATI.SU](https://ati.su/developers/api/dictionaries/geo/#post-v1-autocomplete-suggestions)
- `to_city` — Значение поля `id` в структуре `city` из [словаря ATI.SU](https://ati.su/developers/api/dictionaries/geo/#post-v1-autocomplete-suggestions)
- `volume` — Объем груза в кубических метрах. Обязательный параметр, если не задан параметр weight.
- `weight` — Вес груза в тоннах. Обязательный параметр, если не задан параметр volume.

**Пример ответа (200)**

```json
{
  "price_with_tax": {
    "price": 0
  },
  "price_without_tax": {
    "price": 0
  },
  "price_with_cash": {
    "price": 0
  },
  "is_approximated": false
}
```

**Описание полей ответа**
- `price_with_tax` — Цена с НДС, руб
- `price_without_tax` — Цена без НДС, руб
- `price_with_cash` — Цена наличными, руб
- `is_approximated` — В случае, если параметр `true`, то у нас недостаточно данных по направлению. Учтены дополнительные данные с похожих направлений.

**Пример ответа (404)**

```json
{
  "error_body": "string",
  "reason": "string",
  "details": {}
}
```

**Описание полей ответа**
- `error_body` — основное тело ошибки с описанием
- `reason` — тип ошибки если имеется
- `details` — какие-либо дополнительные детали ошибки