# Авто.ру API для дилеров: POST /user/offers/{category}/{offerID}/products — Подключить услуги объявлению

Отключение услуг — `DELETE /user/offers/{category}/{offerID}/products`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `category` | path | string | да | cars, moto, trucks или all |
| `offerID` | path | string | да | ID объявления |
| `x-session-id` | header | string | да | Сессия пользователя |
| `products` | body | array | да | Подключаемые услуги |
| `products[].code` | body | string | да | all_sale_fresh (поднятие), all_sale_premium (премиум), all_sale_special (спецпредложение), package_turbo (турбо-продажа), reset (сброс) |
| `products[].badges` | body | array | нет | Рекламные тексты для услуги all_sale_badge, до трёх |

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

```
curl -i -X POST 'https://apiauto.ru/1.0/user/offers/cars/1022557788-4a6efe8b/products' -H 'x-authorization: 2dtrer432...' -d '{"products":[{"code": "all_sale_fresh"}]}' -H 'Accept: application/json' -H 'Content-Type: application/json' -H 'x-session-id: 112_aoR02Tpv...'
```

Пример ответа:

```json
{
"status": "SUCCESS"
}
```

## Базовые URL

- Боевой: `https://apiauto.ru/1.0`

## Авторизация

Тип: API-ключ

Токен авторизации запрашивают у аккаунт-менеджера Авто.ру и передают в заголовке `x-authorization` в каждом запросе. Операции с объявлениями и кабинетом дилера дополнительно требуют сессию пользователя: её получают методом `POST /auth/login` и передают в заголовке `x-session-id`. При работе через агентский аккаунт клиента указывают в `x-dealer-id`.

```
curl -i -X GET 'GET https://apiauto.ru/1.0/dealer/account' -H 'x-authorization: fefernrjkgnerkj3453445...'
```

## Нюансы

- Почти все операции с объявлениями требуют обоих заголовков: `x-authorization` (токен) и `x-session-id` (сессия из `/auth/login`).
- Сессия живёт около 90 дней (`ttl_sec` 7776000; в документации единица указана противоречиво — проверьте).
- Ответ может содержать недокументированные служебные поля, порядок полей не гарантирован.
- Подключение платных услуг при нехватке средств возвращает `402`.

## Сценарии с этим методом

- [Продвинуть объявления платными услугами](https://mcp-everything.ru/integrations/autoru/scenarios/prodvinut-obyavleniya-platnymi-uslugami.md)

---

Если этого недостаточно — официальная документация: https://yandex.ru/dev/autoru/doc/ru/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/autoru.md
