API (Application Programming Interface) - это инструмент, который позволяет рекламодателям TrafficStars управлять своими рекламными кампаниями, а паблишерам - сайтами и рекламными местами.
Через API предоставляется вся функциональность, доступная пользователю в веб-интерфейсе admin.trafficstars.com, а также ряд дополнительных функций, упрощающих работу с большими объемами данных и объектов.
Рекламодатели могут использовать API для:
Создания, редактирования, и просмотра кампаний и их групп
Управления настройками таргетинга кампаний
Установки индивидуальных бидов для спотов в кампаниях
Приостановки, запуска и редактирования рекламных креативов
Паблишеры могут использовать API для:
Создания, редактирования и просмотра сайтов (приложений)
Создания, редактирования и просмотра спотов на сайтах
Как начать пользоваться API?
#1 Сгенерировать API ключ (он же токен) в личном кабинете . Полученный токен является offline token в терминологии OAuth 2.0.
#2 Для получения сессионого API-токена необходимо воспользоваться методом Auth by the offline token
Запрос:
Ответ:
В полученном ответе нас интересуют два поля - access_token и refresh_token.
access_token это токен для текущей сессии; он будет использоваться для авторизации всех последующих запросов. Токен действителен в течение expires_in (сек), по умолчанию установлены одни сутки.
- refresh_token может быть сохранен в вашей системе и неоднократно использован для получения нового access_token.
The received access_token can be used for requests to the API as a Bearer token.
Полученный access_token можно использовать для запросов к API в качестве Bearer token. К примеру, получить баланс своего акканута:
Запрос:
Response:
Готово! Теперь вы можете продолжить работу с любым из методов API TrafficStars!
