Разработчик студии, открыв документацию площадки, видит знакомую картину: REST, ключи доступа, методы по разделам. Клиент выдаёт ключи в своём кабинете; студия работает от его имени в пределах выданных прав. Это открывает автоматизацию, которую продавцу самому не сделать, — и одновременно даёт способ быстро упереться в лимиты, если относиться к площадке как к своему бэкенду. Разберём, что есть и что с этим делать.
Разделы API, которые нужны студии
- Автозагрузка: создание и обновление объявлений файлом по ссылке, отчёты о загрузке (что принято, что отклонено и почему), соответствие своих идентификаторов номерам объявлений площадки, информация о карточках.
- Статистика: показы, просмотры, контакты, избранное по объявлениям и по аккаунту, по дням; расходы и операции кошелька; при доступе — звонки.
- Мессенджер: чаты, сообщения, отправка, вебхуки о входящих — зависит от тарифа аккаунта на площадке.
- Продвижение: услуги, прогнозы, ставки на тарифе «за просмотры»; продвижение можно задавать и в файле автозагрузки.
- Рассылки предложений тем, кто добавил в избранное, — с фиксированной аудиторией и шаблонными предложениями.
- Справочники: категории и их поля — спецификация, по которой собирается файл.
Каталог сайта → файл автозагрузки, статистика по API в отчёт, заявки с площадки в CRM. Один кабинет на всех клиентов, доступ по ключам, которые клиент отзывает сам. 3 дня бесплатно, регистрация без карты.
Ограничения, о которые бьются
- Лимиты частоты. У методов есть квоты запросов в минуту; при превышении — ответ «слишком часто», а при упорстве — временные ограничения. Опрос статистики по тысяче объявлений в лоб кладёт аккаунт клиента на час.
- Доступ по тарифу. Часть методов (мессенджер, коллтрекинг) доступна не всем аккаунтам; проверяйте до того, как обещать клиенту интеграцию чатов.
- Токены живут ограниченное время — кэшируйте, не запрашивайте на каждый вызов.
- Спецификации категорий меняются — файл, который принимали вчера, может получить новые обязательные поля.
- Идентификаторы объявлений в файле нельзя менять — смена = новое объявление и потеря истории.
Что писать самим, что брать готовым
Самим — то, что специфично для клиента: выгрузка из его каталога в файл, мэппинг категорий, бизнес-правила цен. Готовым — то, что одинаково у всех и требует поддержки: сбор статистики с пейсингом под лимиты, доставка чатов в CRM с повторами и дедупликацией, уникализация текстов и фото, перепубликация по циклам, правила продвижения. Это уже сделано в сервисах автозагрузки, и переписывать это ради одного клиента — месяцы, которые студия не продаст.
Архитектура, которая не ломает аккаунт
- Один сборщик статистики на аккаунт с расписанием и отступом после «слишком часто».
- Кэш ответов (карточки, справочники) с разумным сроком.
- Очередь исходящих (ответы в чаты, ставки) с повторами и журналом.
- Журнал всех вызовов по клиенту — чтобы при вопросе «почему объявление пропало» был ответ.
- Ключи клиента — отзываемые им, хранятся отдельно, не в коде.
Что продавать
Интеграция каталога, сбор аналитики, чаты в CRM — три услуги с разработкой, которые клиент не сделает сам, а продавец ценит выше «ещё одного лендинга». Главное — считать, что площадка принадлежит клиенту: автоматизация должна работать так, чтобы он мог в любой момент отозвать ключи и остаться с рабочим аккаунтом.