❗️
ДАННАЯ СТАТЬЯ БОЛЕЕ НЕ АКТУАЛЬНА. МЫ ПЕРЕЕЗЖАЕМ В ИНТЕРКОМ!
http://help-center.peerclick.com/ru
ПРИСОЕДИНЯЙТЕСЬ И НАХОДИТЕ ВСЮ АКТУАЛЬНУЮ ИНФОРМАЦИЮ ПО РАБОТЕ С PEERCLICK!

PeerClick предоставляет API REST-типа, используя безопасные методы HTTPS в качестве транспортного уровня и JSON в качестве формата. Наш центральный API gateway api.peerclick.com используется для обработки всех запросов к соответствующим микро-службам путем включения различных суффиксов каталогов. Полная документация по API доступна по адресу http://developers.peerclick.com .

📘

Если вы хотите использовать PeerClick API, вы должны помнить, что существует ограничение в 3 запроса API в секунду.

Если вы хотите использовать PeerClick API с использованием ключа доступа, вам необходимо сгенерировать его в PeerClick. Чтобы узнать больше, перейдите в раздел ниже.

Анатомия запроса URL

URL запроса может выглядеть следующим образом:

https://api.peerclick.com/v1/report?groupBy=campaign&from=2020-01-01

где:

https://api.peerclick.com/v1 - URL базового запроса. URL базового запроса фиксированный и одинаков для всех запросов.
/report - суффикс директория.
?groupBy=campaign&from=2020-01-01 - дополнительные параметры запроса в зависимости от вашего выбора.

Примеры суффиксов директория:

/report
/campaign
/offer

Некоторые запросы также требуют добавления ID компонента после служебного каталога, те, которые четко указаны в нашей документации API через фигурные скобки, например:

/ campaign / {campaignId}

где {campaignId} необходимо заменить на ID кампании из вашей учетной записи PeerClick. Дополнительные параметры затем помещаются в строку запроса URL (после знака вопроса ?) для описания запрошенных данных, например:

?withPages=1

Начало работы с API

Чтобы работать с API, вам нужно:

Получить ключ через панель в разделе Настройки - Безопасность.
Получить токен ключа через POST/auth/access/session.
Залогиниться с этим токеном на https://developers.peerclick.com/.

1. Создание ключа

Чтобы получить ключ доступа:

Зайдите в Настройки.
Перейдите в раздел Безопасность.
В разделе Ключи доступа нажмите кнопку Создать новый ключ.

Назовите ваш ключ и введите пароль вашего аккаунта.

Сохраните ваш ключ в безопасном месте. Все токены, созданные под этим ключом, будут привязаны к нему, и будут утеряны при удалении этого ключа.

2. Создание токена ключа

Перейдите по адресу https://developers.peerclick.com
В разделе Security через POST /auth/access/session создайте токен ключа.

Введите сгенерированные в панели ключи в заданном формате.

Скопируйте полученный токен ключа.

🚧
Обращаем внимание, что у токена ключа есть время жизни, по умолчанию равное 86400 секунд, т.е. 1 день. Вы можете изменить lifetime токена ключа при его создании.

3. Авторизация в веб-интерфейсе

Авторизируйтесь на https://developers.peerclick.com/ через кнопку Authorize, введя в поле значение сгенерированного токена.