Что такое получение статистики по API?
Это ссылка (API) для получения информации по вашим объявлениям, размещенным на Домклик. С помощью API предоставляется доступ к опубликованным объявлениям в рамках одной компании. API не предназначена для использования вручную — ею следует пользоваться для налаживания интеграции между CRM-системой агентства недвижимости (застройщика) и Домклик.
Зачем нужна статистика по API?
Она дает возможность получать следующую информацию о ваших объявления непосредственно в вашей CRM:
- статусы по итогам размещения объявления через фид: успешно опубликовано, ошибка публикации с указанием причин
- статистику по просмотрам объявления и по просмотрам телефонов
- признак платного продвижения
- ссылки на опубликованные объявления на Домклик
Что нужно сделать, чтобы получить доступ к статистике по API?
- В Личном кабинете в разделе «статистика» перейти в раздел подключения обратного статистики по API
- Подключить или перевыпустить существующий токен (ключ доступа)
- Передать ссылку и токен вашим программистам или компании, предоставляющей вам CRM со ссылкой на инструкцию
Инструкция для разработчиков
Для доступа необходимо использовать предоставленную ссылку, например: https://my.domclick.ru/api/v1/company/123/report
Для прохождения авторизации необходимо установить предоставленный токен в HTTP-заголовок Authorization. Пример выполнения команды для скачивания отчета:
curl https://my.domclick.ru/api/v1/company/123/report -H 'Authorization: Token a3a822063b744f1d82a6fae4c5978211’ > result.xml
После выполнения команды в файле resut.xml будет предоставлены результаты импорта / публикации объявлений по компании.