Авто.ру 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...'

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

{
"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://yandex.ru/dev/autoru/doc/ru/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/autoru.md