Работа с API

❗️

ДАННАЯ СТАТЬЯ БОЛЕЕ НЕ АКТУАЛЬНА. МЫ ПЕРЕЕЗЖАЕМ В ИНТЕРКОМ!
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, вам нужно:

  1. Получить ключ через панель в разделе Настройки - Безопасность.

  2. Получить токен ключа через POST/auth/access/session.

  3. Залогиниться с этим токеном на https://developers.peerclick.com/.

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

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

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

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

469

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

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

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

1465

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

1483

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

863

🚧

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

1441

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

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

869