REST API RastroAff: ключи, права, эндпоинты и лимиты

Как создать API-ключ, что может каждый тип аккаунта, основные эндпоинты для офферов, партнёров, конверсий и отчётов, и лимиты запросов.

Обновлено 6 нояб. 2026 г.

REST API даёт программный доступ к тому, что вы видите в панели. Доступен с тарифа Starter.

Создать ключ

В меню API создайте ключ. Выберите, может ли он только читать или ещё и записывать, и при желании срок действия. Ключ (начинается с rst_) показывается один раз: сохраните его в надёжном месте. Отозвать его можно в любой момент.

Передавайте его в заголовке каждого запроса:

curl https://rastroaff.com/api/v1/me -H "Authorization: Bearer rst_..."

Что видит каждый ключ

У ключа тип и область видимости аккаунта, который его создал:

Администратор: вся сеть.
Менеджер: назначенные ему партнёры.
Рекламодатель: свои кампании; может регистрировать конверсии и отправлять активность игроков.
Партнёр: свой трафик, заработок и выплаты.

Аккаунтам администраторов для работы с API нужна включённая двухфакторная аутентификация.

Эндпоинты

/api/v1/campaigns: список, создание, изменение и смена статуса офферов.
/api/v1/affiliates и /api/v1/advertisers: список, просмотр, изменение, одобрение.
/api/v1/clicks и /api/v1/conversions: списки и, для рекламодателей, регистрация конверсий.
/api/v1/reports: тот же движок, что и отчёты в панели.
/api/v1/payouts: запросы на выплату и их статус.
/api/v1/postbacks: журнал отправленных постбэков.

Полная спецификация (OpenAPI 3.1) — по адресу /api/v1/openapi.json, на языке запроса.

Лимиты и ошибки

600 запросов в минуту на ключ. Заголовки X-RateLimit-* показывают остаток; при превышении ответ — 429.
Ошибки приходят в JSON с кодом (unauthorized, insufficient_scope, validation_error…) и сообщением.

Чтобы получать события, а не запрашивать их, используйте вебхуки.