Интеграция с Авито работала неделю, а потом сообщения перестали приходить, и в логах появились непонятные 401 и 429. Меня зовут Антон Сапченко, я авитолог-практик, основатель агентства Sapchenko Studio и сервиса Sapix. Разберу самые частые ошибки API Авито: что они значат, почему возникают и как их исправить без паники.
API Авито развивается: появляются новые методы, меняются версии и ограничения. Ниже — логика работы простыми словами; точные адреса методов, параметры и лимиты сверяйте с официальной документацией Авито для разработчиков на дату настройки.
Как вообще устроен доступ к API
Работа с API Авито начинается с ключей: Client ID и Client Secret. По ним вы получаете токен доступа и прикладываете его к каждому запросу. У токена ограниченный срок жизни — он указан в ответе при выдаче. Когда срок выходит, нужно получить новый. Подробнее о ключах — в статье как получить API-ключ Авито, а о структуре методов — в материале документация API Авито простыми словами.
401 — не авторизован
Самая частая ошибка. Авито не принимает ваш токен.
- Токен истёк. Решение — автоматически запрашивать новый до окончания срока или при первом 401.
- Неверные ключи. Опечатка, лишний пробел, ключи от другого аккаунта.
- Ключи перевыпустили. Если владелец аккаунта сгенерировал новые ключи, старые перестают работать.
403 — доступ запрещён
Токен действителен, но на это действие прав нет.
- метод недоступен для вашего типа аккаунта или тарифа;
- вы обращаетесь к данным другого аккаунта;
- у приложения нет нужного разрешения.
Проверьте, какие возможности API открыты вашему аккаунту, — это зависит от его типа и подключённых инструментов Авито для бизнеса.
404 — не найдено
Неверный адрес метода, устаревшая версия API или объект, которого уже нет: удалённый чат, снятое объявление. Сверьте путь с актуальной документацией.
429 — слишком много запросов
У API есть ограничения на частоту запросов. Если превысить лимит, Авито временно перестаёт отвечать на ваши запросы. Что делать:
- Делайте паузу и повторяйте. При 429 не бомбите API повторами — увеличивайте интервал между попытками.
- Не опрашивайте зря. Для сообщений используйте вебхуки вместо частого опроса — об этом в статье вебхуки Авито.
- Кэшируйте. Данные, которые меняются редко, не нужно запрашивать каждую минуту.
- Распределяйте нагрузку. Если аккаунтов много, не запускайте все запросы в одну секунду.
5xx — ошибки на стороне Авито
500, 502, 503 означают, что проблема не у вас. Правильная реакция — повторить запрос позже с паузой и не терять данные: ставить задачу в очередь, а не выбрасывать её.
Как не терять данные из-за ошибок
- Логируйте каждый ответ API с кодом и временем.
- Обновляйте токен автоматически.
- Повторяйте неудачные запросы с растущей паузой.
- Настройте оповещение, если ошибки идут подряд.
- Периодически сверяйте данные полностью, чтобы найти пропуски.
Для авитолога, который ведёт много клиентов, ошибка в одном аккаунте легко теряется среди остальных. Поэтому важно видеть статус каждого подключения — так устроен мониторинг аккаунтов Sapix: если с аккаунтом что-то не так, вы узнаёте об этом сразу.
А если проблема не в технике, а в том, что объявления не приносят обращений, начните с аудита аккаунта Авито.
Частые вопросы
Почему API Авито вдруг перестал работать?
Чаще всего истёк токен или владелец перевыпустил ключи. Реже — превышен лимит запросов или изменилась версия метода.
Сколько живёт токен Авито?
Ограниченное время, которое указано в ответе при выдаче токена. Закладывайте автоматическое обновление.
Какие лимиты у API Авито?
Они зависят от метода и могут меняться. Ориентируйтесь на документацию и на ответ 429 как на сигнал снизить частоту.
Можно ли избежать этих проблем без программиста?
Да, если работать через сервис, который сам обновляет токены, повторяет запросы и следит за лимитами.
Подключите Авито без программиста
Sapix работает с официальным API Авито: вы вставляете ключи, а сообщения, отзывы, статистика и уведомления собираются в одном окне. Первый месяц бесплатно, карта не нужна.
