Offers API. Desain Anda, penawaran kami.
Dapatkan penawaran untuk setiap pengguna dalam format JSON, dengan gambar, langkah, dan hadiah yang sudah dalam mata uang Anda, lalu tampilkan di kartu Anda sendiri, di samping konten Anda. Hadiah dikirim melalui postback, sama seperti dengan offerwall.
- JSONREST melalui HTTPS
- 600Permintaan per menit
- OpenAPITermasuk spesifikasi
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"Mulai live dalam tiga langkah.
Salin kode, ganti placeholder dengan nilai dari dasbor Anda di Offerwall, offerwall Anda, Integrasi, lalu uji sebelum Anda meluncurkannya.
-
Minta penawaran untuk satu pengguna
Panggil API dari server Anda dengan API key aplikasi Anda, user ID, negara tempat pengguna berada, serta perangkat atau user agent mereka. Daftar ini tidak menyertakan penawaran yang sudah diselesaikan pengguna atau yang belum dapat dikerjakan lagi.
Terminalcurl -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() -
Tampilkan dengan desain Anda sendiri
Setiap penawaran dilengkapi judul, gambar, langkah, dan hadiah dalam mata uang Anda. Tampilkan sesuka Anda, dan arahkan pengguna ke start_url penawaran saat mereka memilihnya. Halaman penawaran dibuka di Moonetix dan dari sana membawa mereka ke pengiklan.
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, })); } -
Kreditkan hadiah dengan postback
Setiap hadiah sampai ke server Anda sebagai postback bertanda tangan. Periksa hash, tambahkan hadiah satu kali per ID transaksi, dan tarik kembali jika postback berikutnya membatalkannya. Postback yang gagal dicoba ulang hingga 5 kali.
Dasbor, tab Postbackhttps://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/..."
}
- Buat akun+325
- Capai level 10+650
Dari JSON ke desain Anda
Setiap penawaran siap ditampilkan, dengan langkah dan hadiahnya sudah dalam mata uang Anda.
Apa yang diberikan API kepada Anda
- Penawaran per pengguna
Penawaran disesuaikan dengan negara dan perangkat yang Anda kirim, dan penawaran yang sudah diselesaikan pengguna tidak disertakan.
- Hadiah dalam mata uang Anda
Setiap hadiah sudah dihitung dengan nilai konversi, bagian pengguna, pembulatan, dan bonus yang sedang berjalan.
- Langkah dan gambar
Penawaran multi-langkah mencantumkan setiap langkah dengan hadiahnya masing-masing, sehingga Anda dapat menunjukkan dengan tepat apa saja yang dibayar.
- Sub ID
Kirim hingga lima nilai Anda sendiri. Nilai-nilai ini ditambahkan ke setiap start_url dan dikembalikan dalam postback.
- Penawaran yang disembunyikan tetap tersembunyi
Penawaran yang Anda sembunyikan di halaman "Penawaran" juga tidak disertakan di API, sehingga sesuai dengan offerwall Anda.
- Spesifikasi OpenAPI
File openapi.json yang dapat dibaca mesin menjelaskan setiap field, siap untuk code generator dan agen coding AI.
Uji dulu, lalu luncurkan.
Semua yang perlu Anda periksa sebelum pengguna sungguhan melihat offerwall Anda, dengan alat yang sudah tersedia di dasbor Anda.
Buka sebagai pengguna uji
Di "Status integrasi" pada tab "Integrasi", buka offerwall Anda sebagai pengguna owner-test. Kunjungan uji tidak dihitung sebagai pengguna.
Panggil API dengan curl
Minta daftar untuk user ID uji dan negara tempat penawaran tersedia, lalu buka salah satu start_url di browser.
Kirim postback uji
Pilih pengguna, status, dan pembayaran, lalu lihat respons persis dari server Anda, lengkap dengan kode respons dan waktunya. ID transaksi uji diawali test_.
Uji dari koneksi biasa
VPN, proxy, Tor, dan jaringan cloud diblokir, jadi lakukan pengujian dengan Wi-Fi rumah atau data seluler, di negara tempat penawaran tersedia.
Daftar periksa peluncuran
0 dari 10 siap
Siap diluncurkan. Progres Anda disimpan di browser ini.
Error umum, cepat teratasi.
Hal yang mungkin Anda temui saat mengintegrasikan Offers API, penyebabnya, dan solusinya.
400 invalid_countryAda parameter yang hilang atau salah: invalid_user_id, invalid_country, atau invalid_device.
SolusiPerbaiki parameter yang disebut dalam kode error.
401 invalid_api_keyKey tidak ada, salah, atau sudah diganti.
SolusiKirim di header Authorization sebagai Bearer, dan salin lagi dari tab "Integrasi".
403 app_not_liveAplikasi sedang dijeda, atau akun Anda belum disetujui atau tidak aktif.
SolusiPeriksa notifikasi Anda. Jika user_blocked, jangan tampilkan penawaran kepada pengguna tersebut.
429 rate_limitedLebih dari 600 permintaan dalam satu menit untuk aplikasi ini.
SolusiTunggu sesuai detik di Retry-After, dan simpan daftar setiap pengguna di cache selama 1 hingga 5 menit.
Empty offers listIni adalah respons normal: saat ini tidak ada penawaran yang tersedia untuk pengguna tersebut.
SolusiTampilkan pesan yang ramah saat daftar kosong, dan periksa negara serta perangkat yang Anda kirim.
VPN detected on start_urlPengguna menggunakan VPN, proxy, atau jaringan cloud saat halaman penawaran dibuka.
SolusiMinta pengguna untuk mematikannya. Permintaan API dari server Anda tidak diperiksa.
Postback log shows 403 or 404Skrip Anda menolak postback, atau URL-nya salah.
SolusiBuka URL dari log di browser dan periksa kode hash Anda.
Postback log shows a timeoutSkrip Anda membutuhkan lebih dari 6 detik untuk merespons.
SolusiBalas dengan 200 terlebih dahulu, lalu jalankan proses yang lambat di latar belakang.
Postback log shows 301 or 302URL Anda melakukan redirect, misalnya dari http ke https.
SolusiGunakan URL akhir. Postback tidak mengikuti redirect.
Tidak ditemukan. Lihat daftar lengkap di dokumentasi atau hubungi kami.
Sekilas pandang
- Endpoint
- GET https://api.moonetix.com/v1/offers
- Autentikasi
- API key Bearer, satu per aplikasi, hanya di sisi server
- Parameter wajib
- user_id, country, dan device atau ua
- Batas permintaan
- Hingga 600 permintaan per menit untuk setiap aplikasi
- Format
- JSON, dengan deskripsi OpenAPI
- Harga
- Gratis untuk publisher yang disetujui
Integrasi lainnya
- Situs webLink, iframe, atau tombol Earn mengambang. Tanpa SDK.
- Android SDKLayar offerwall native untuk aplikasi Kotlin dan Java.
- iOS SDKOfferwall native untuk Swift, SwiftUI, dan Objective-C.
- Unity SDKPenawaran berhadiah untuk game Android dan iOS, dari C#.
- Flutter SDKSatu plugin Dart untuk Android dan iOS.
- React Native SDKUntuk aplikasi React Native dan Expo, dengan tipe TypeScript.
- Semua integrasiBandingkan secara berdampingan.
Pertanyaan seputar Offers API
Pertanyaan developer sebelum menambahkan Offers API.
Mengalami kendala? Hubungi kami
Kapan sebaiknya saya menggunakan Offers API, bukan offerwall?
Gunakan link offerwall untuk mulai live paling cepat. Gunakan Offers API jika Anda ingin penawaran tampil di dalam situs atau aplikasi Anda sendiri, dengan desain Anda sendiri, misalnya di samping penawaran dari sumber lain atau di toko hadiah Anda sendiri.
Apakah saya bisa memanggil Offers API dari browser atau aplikasi seluler?
Tidak. Panggil hanya dari server Anda, karena permintaan tersebut membawa kunci API Anda. Jika kunci bocor, buat kunci baru di tab "Integrasi" dan kunci lama langsung berhenti berfungsi.
Negara mana yang harus saya kirim?
Negara tempat pengguna benar-benar berada, sebagai kode dua huruf seperti US. Penawaran dan hadiah bergantung pada negara ini, dan negara serta perangkat diperiksa lagi saat pengguna memulai penawaran.
Apakah hadiahnya berbeda dari offerwall?
Tidak. API mengembalikan penawaran yang sama dengan offerwall Anda, dengan hadiah yang sama, dan setiap langkah yang diselesaikan sampai ke server Anda melalui postback bertanda tangan yang sama.
Apakah ada batas jumlah permintaan?
Ya, hingga 600 permintaan per menit untuk setiap aplikasi. Simpan daftar di cache untuk waktu singkat per pengguna jika Anda sering menampilkannya.
Apakah key yang sama dapat digunakan untuk hal lain?
Ya. API key sebuah aplikasi juga berfungsi untuk Reporting API dan untuk sesi SDK seluler.
Ubah trafik Anda menjadi penghasilan.
Buat akun publisher gratis dan dapatkan penghasilan dari setiap penawaran yang diselesaikan pengguna Anda di situs web, aplikasi, game, atau komunitas Anda.