How-to рецепты

How-to раздел собирает рецепты для конкретных задач интеграции. Каждый рецепт показывает один рабочий сценарий, минимальный набор настроек и ссылки на reference-страницы с полным контрактом.

Рецепт	Задача
Авторизация и конфигурация	Создать клиент через env, явные ключи или AvitoSettings
Профиль, баланс и иерархия аккаунта	Получить профиль, баланс, историю операций и данные сотрудников
Объявления, статистика и продвижение	Найти объявления, открыть карточку, прочитать статистику и подготовить VAS
Продвижение с dry-run	Проверить payload write-операции без сетевого вызова
Чаты, сообщения и изображения	Отправить текст, загрузить изображение и отправить его в чат
Заказы, этикетки и остатки	Создать задачу генерации, скачать PDF и обновить остатки
Вакансии, отклики и резюме	Получить отклики, обработать их и настроить webhook
Отчёт Автотеки	Пройти цепочку VIN → preview → report
Бронирование недвижимости	Обновить блокировки дат и цены
CPA и CallTracking	Найти звонки и скачать запись
Рейтинги, отзывы и тарифы	Получить отзывы, ответить на отзыв и прочитать тариф
Пагинация	Читать PaginatedList частями и материализовать весь список
Per-operation overrides	Настроить таймауты, retry-политику и idempotency key
Идемпотентность	Безопасно повторять write-операции с idempotency_key
Тестирование с FakeTransport	Проверить consumer-код без реального HTTP
Диагностика и логирование	Использовать debug_info() и типизированные исключения
Безопасная работа с SDK	Хранить секреты и логировать безопасно

Для первого запуска начните с быстрого старта. Для поиска метода по операции API используйте карту операций.