Offers API. Ваш дизайн, наши офферы.
Получайте офферы для каждого пользователя в JSON, с изображениями, шагами и наградами уже в вашей валюте, и показывайте их в собственных карточках рядом с вашим контентом. Награды приходят через postback, так же как с offerwall.
- JSONREST через HTTPS
- 600Запросов в минуту
- OpenAPIСпецификация в комплекте
curl -G "https://api.moonetix.com/v1/offers" \
-d user_id=user_1234 -d country=US -d device=android \
-H "Authorization: Bearer $MOONETIX_API_KEY"Запуск за три шага.
Скопируйте код, замените плейсхолдеры значениями из личного кабинета (Offerwall, ваш offerwall, Интеграция) и протестируйте перед запуском.
-
Запросите офферы для одного пользователя
Вызывайте API со своего сервера с API-ключом вашего приложения, ID пользователя, страной, в которой находится пользователь, и его устройством или user agent. В список не попадают офферы, которые пользователь уже выполнил или пока не может выполнить снова.
Терминалcurl -G "https://api.moonetix.com/v1/offers" \ -d user_id=user_1234 -d country=US -d device=android \ -H "Authorization: Bearer $MOONETIX_API_KEY"offers.php<?php $query = http_build_query([ 'user_id' => $userId, 'country' => $countryCode, 'ua' => $_SERVER['HTTP_USER_AGENT'] ?? '', ]); $ch = curl_init('https://api.moonetix.com/v1/offers?' . $query); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $apiKey], ]); $data = json_decode((string)curl_exec($ch), true);offers.jsconst params = new URLSearchParams({ user_id: userId, country: countryCode, ua: req.headers['user-agent'] || '', }); const res = await fetch(`https://api.moonetix.com/v1/offers?${params}`, { headers: { Authorization: `Bearer ${process.env.MOONETIX_API_KEY}` }, }); const data = await res.json();offers.pyimport os, requests r = requests.get( "https://api.moonetix.com/v1/offers", params={"user_id": user_id, "country": country_code, "ua": user_agent}, headers={"Authorization": f"Bearer {os.environ['MOONETIX_API_KEY']}"}, timeout=10, ) data = r.json() -
Показывайте их в собственном дизайне
Каждый оффер приходит с названием, изображением, шагами и наградой в вашей валюте. Отображайте их как угодно, а когда пользователь выберет оффер, отправьте его на start_url этого оффера. Страница оффера открывается на Moonetix и уже оттуда ведет к рекламодателю.
JSON{ "ok": true, "currency": "Coins", "offers": [ { "id": 58, "title": "Nova Quest: reach level 10", "reward": 975, "payout_usd": 1.5, "start_url": "https://wall.moonetix.com/..." } ] }offers.jsfor (const offer of data.offers) { list.append(card({ title: offer.title, reward: `${offer.reward} ${data.currency}`, href: offer.start_url, })); } -
Начисляйте награды через postback
Каждая награда приходит на ваш сервер в виде подписанного postback. Проверьте хеш, начислите награду один раз на каждый ID транзакции и спишите ее, если последующий postback ее отменяет. Неудачные postback отправляются повторно до 5 раз.
Личный кабинет, вкладка "Postback"https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}postback.php<?php $tx = $_GET['tx'] ?? ''; $userId = $_GET['user'] ?? ''; $reward = $_GET['reward'] ?? ''; $status = $_GET['status'] ?? ''; $secret = getenv('MOONETIX_POSTBACK_SECRET'); $expected = hash_hmac('sha256', "$tx:$userId:$reward:$status", $secret); if (!hash_equals($expected, $_GET['hash'] ?? '')) { http_response_code(403); exit; } if ($status === '1') { credit_once($userId, $tx, $reward); // once per transaction ID } elseif ($status === '2') { reverse_if_credited($userId, $tx, $reward); } http_response_code(200);postback.jsconst crypto = require('crypto'); app.get('/postback', (req, res) => { const { tx, user, reward, status, hash } = req.query; const secret = process.env.MOONETIX_POSTBACK_SECRET; const expected = crypto.createHmac('sha256', secret) .update(`${tx}:${user}:${reward}:${status}`) .digest('hex'); const valid = typeof hash === 'string' && hash.length === expected.length && crypto.timingSafeEqual(Buffer.from(hash), Buffer.from(expected)); if (!valid) return res.sendStatus(403); if (status === '1') creditOnce(user, tx, reward); // once per transaction ID if (status === '2') reverseIfCredited(user, tx, reward); res.sendStatus(200); });postback.pyimport hmac, hashlib, os from flask import request, abort @app.get("/postback") def postback(): a = request.args parts = [a.get(k, "") for k in ("tx", "user", "reward", "status")] msg = ":".join(parts) secret = os.environ["MOONETIX_POSTBACK_SECRET"].encode() expected = hmac.new(secret, msg.encode(), hashlib.sha256).hexdigest() if not hmac.compare_digest(expected, a.get("hash", "")): abort(403) if a.get("status") == "1": credit_once(a["user"], a["tx"], a["reward"]) # once per transaction ID elif a.get("status") == "2": reverse_if_credited(a["user"], a["tx"], a["reward"]) return "", 200
{
"title": "Nova Quest: reach level 10",
"goals": [
{ "name": "Create an account", "reward": 325 },
{ "name": "Reach level 10", "reward": 650 }
],
"reward": 975,
"start_url": "https://wall.moonetix.com/..."
}
- Создать аккаунт+325
- Достигните 10 уровня+650
От JSON к вашему дизайну
Каждый оффер приходит готовым к отображению, с шагами и наградами уже в вашей валюте.
Что дает вам API
- Офферы на пользователя
Офферы подбираются под страну и устройство, которые вы передаете, а те, что пользователь уже выполнил, исключаются.
- Награды в вашей валюте
Каждая награда уже рассчитана с учетом вашего курса конвертации, доли пользователя, округления и действующего бонуса.
- Шаги и изображения
В многоэтапных офферах указан каждый шаг с собственной наградой, поэтому вы можете точно показать, за что платят.
- Sub ID
Передавайте до пяти собственных значений. Они добавляются к каждому start_url и возвращаются в postback.
- Скрытые офферы остаются скрытыми
Офферы, которые вы скрываете на странице "Офферы", исключаются и из API, поэтому он совпадает с вашим offerwall.
- Спецификация OpenAPI
Машиночитаемый файл openapi.json описывает каждое поле и готов для генераторов кода и ИИ-агентов для программирования.
Протестируйте, затем запускайте.
Все, что нужно проверить, прежде чем реальные пользователи увидят ваш offerwall, с помощью инструментов, встроенных в личный кабинет.
Открыть как тестовый пользователь
В блоке "Статус интеграции" на вкладке "Интеграция" откройте свой offerwall как пользователь owner-test. Тестовые визиты не учитываются как пользователи.
Вызов API через curl
Запросите список для тестового ID пользователя и страны, где доступны офферы, и откройте один start_url в браузере.
Отправить тестовый postback
Выберите пользователя, статус и выплату и посмотрите, что именно ответил ваш сервер, с кодом ответа и временем. ID тестовых транзакций начинаются с test_.
Тестируйте с обычного подключения
VPN, прокси, Tor и облачные сети блокируются, поэтому тестируйте через домашний Wi-Fi или мобильный интернет, в стране, где доступны офферы.
Чек-лист запуска
0 из 10 готово
Все готово к запуску. Ваш прогресс сохраняется в этом браузере.
Частые ошибки и быстрые решения.
Что вы можете увидеть при интеграции Offers API, в чем причина и как это исправить.
400 invalid_countryПараметр отсутствует или неверен: invalid_user_id, invalid_country или invalid_device.
РешениеИсправьте параметр, указанный в коде ошибки.
401 invalid_api_keyКлюч отсутствует, неверен или был заменен.
РешениеОтправляйте его в заголовке Authorization как Bearer и скопируйте его заново на вкладке "Интеграция".
403 app_not_liveПриложение приостановлено, или ваш аккаунт не одобрен или неактивен.
РешениеПроверьте уведомления. При user_blocked не показывайте этому пользователю офферы.
429 rate_limitedБолее 600 запросов в минуту для этого приложения.
РешениеПодождите указанное в Retry-After число секунд и кешируйте список каждого пользователя на 1-5 минут.
Empty offers listЭто нормальный ответ: для этого пользователя сейчас ничего нет.
РешениеПокажите понятное пустое состояние и проверьте страну и устройство, которые вы передаете.
VPN detected on start_urlПользователь подключен через VPN, прокси или облачную сеть, когда открывается страница оффера.
РешениеПопросите пользователя отключить его. Запросы к API с вашего сервера не проверяются.
Postback log shows 403 or 404Ваш скрипт отклонил postback, или URL неверен.
РешениеОткройте URL из лога в браузере и проверьте код, который вычисляет хеш.
Postback log shows a timeoutВаш скрипт отвечает дольше 6 секунд.
РешениеСначала отвечайте кодом 200, а медленную работу выполняйте в фоне.
Postback log shows 301 or 302Ваш URL выполняет редирект, например с http на https.
РешениеИспользуйте конечный URL. Postback-запросы не следуют редиректам.
Ничего не найдено. Посмотрите полный список в документации или свяжитесь с нами.
Коротко о главном
- Эндпоинт
- GET https://api.moonetix.com/v1/offers
- Аутентификация
- API-ключ Bearer, по одному на приложение, только на сервере
- Обязательные параметры
- user_id, country и device или ua
- Ограничение запросов
- До 600 запросов в минуту для каждого приложения
- Формат
- JSON с описанием OpenAPI
- Цена
- Бесплатно для одобренных паблишеров
Другие интеграции
- СайтСсылка, iframe или плавающая кнопка Earn. SDK не нужен.
- Android SDKНативный экран offerwall для приложений на Kotlin и Java.
- iOS SDKНативный offerwall для Swift, SwiftUI и Objective-C.
- Unity SDKОфферы с наградами для игр на Android и iOS, прямо из кода на C#.
- Flutter SDKОдин плагин на Dart для Android и iOS.
- React Native SDKДля приложений React Native и Expo, с типами TypeScript.
- Все интеграцииСравните их между собой.
Вопросы об Offers API
Что спрашивают разработчики, прежде чем подключить Offers API.
Что-то не получается? Свяжитесь с нами
Когда стоит использовать Offers API вместо offerwall?
Используйте ссылку на offerwall, чтобы запуститься быстрее всего. Используйте Offers API, если хотите разместить офферы внутри своего сайта или приложения в собственном дизайне, например рядом с офферами из других источников или в своем магазине наград.
Можно ли вызывать Offers API из браузера или мобильного приложения?
Нет. Вызывайте его только со своего сервера, потому что запрос содержит ваш API-ключ. Если ключ когда-нибудь утечет, создайте новый на вкладке "Интеграция", и старый сразу перестанет работать.
Какую страну передавать?
Страна, в которой пользователь действительно находится, в виде двухбуквенного кода, например US. От нее зависят офферы и награды, а страна и устройство проверяются повторно, когда пользователь начинает оффер.
Отличаются ли награды от наград в offerwall?
Нет. API возвращает те же офферы, что и ваш offerwall, с теми же наградами, а каждый выполненный шаг приходит на ваш сервер через тот же подписанный postback.
Есть ли ограничение на число запросов?
Да, до 600 запросов в минуту для каждого приложения. Если вы часто показываете список, кешируйте его ненадолго для каждого пользователя.
Подходит ли этот ключ для чего-то еще?
Да. API-ключ приложения также работает для Reporting API и для сессий мобильных SDK.
Узнайте больше.
Превратите свой трафик в доход.
Создайте бесплатный аккаунт паблишера и зарабатывайте на каждом оффере, который ваши пользователи выполняют на вашем сайте, в приложении, игре или сообществе.