Offers API. Sizin tasarımınız, bizim tekliflerimiz.
Her kullanıcı için teklifleri; görseller, adımlar ve sizin para biriminizdeki ödüllerle JSON olarak alın ve kendi kartlarınızda, kendi içeriğinizin yanında gösterin. Ödüller, offerwall'da olduğu gibi postback ile gelir.
- JSONHTTPS üzerinden REST
- 600Dakika başına istek
- OpenAPITanım dahil
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"Üç adımda yayına geçin.
Kodu kopyalayın, yer tutucuları panelinizde Offerwall'lar, offerwall'unuz, Entegrasyon altındaki değerlerle değiştirin ve yayına geçmeden önce test edin.
-
Bir kullanıcı için teklifleri isteyin
API'yi sunucunuzdan; uygulamanızın API anahtarı, kullanıcı ID'si, kullanıcının bulunduğu ülke ve cihazı veya user agent'ı ile çağırın. Liste, kullanıcının zaten tamamladığı veya henüz tekrar yapamayacağı teklifleri dışarıda bırakır.
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() -
Onları kendi tasarımınızda gösterin
Her teklif başlığı, görseli, adımları ve sizin para biriminizdeki ödülüyle gelir. Onları istediğiniz gibi gösterin ve kullanıcı bir teklif seçtiğinde onu teklifin start_url adresine gönderin. Teklif sayfası Moonetix'te açılır ve kullanıcıyı oradan reklamverene yönlendirir.
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, })); } -
Ödülleri postback ile yükleyin
Her ödül sunucunuza imzalı bir postback olarak ulaşır. Hash'i kontrol edin, ödülü her işlem ID'si için bir kez ekleyin ve sonraki bir postback onu iptal ederse geri alın. Başarısız postback'ler 5 kereye kadar yeniden denenir.
Panel, Postback sekmesihttps://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/..."
}
- Hesap oluşturun+325
- 10. seviyeye ulaşın+650
JSON'dan kendi tasarımınıza
Her teklif gösterilmeye hazır gelir; adımları ve ödülleri zaten sizin para biriminizdedir.
API'nin size sundukları
- Kullanıcı başına teklifler
Teklifler gönderdiğiniz ülkeye ve cihaza göre eşleşir; kullanıcının zaten bitirdikleri dışarıda bırakılır.
- Sizin para biriminizde ödüller
Her ödül, kurunuz, kullanıcı payınız, yuvarlama ayarınız ve devam eden bonuslarla önceden hesaplanmıştır.
- Adımlar ve görseller
Çok adımlı teklifler her adımı kendi ödülüyle listeler, böylece tam olarak neyin ödeme yaptığını gösterebilirsiniz.
- Sub ID'ler
Kendi değerlerinizden en fazla beşini gönderin. Her start_url'ye eklenir ve postback'te geri gelir.
- Gizlenen teklifler gizli kalır
Teklifler sayfasında gizlediğiniz teklifler API'den de çıkarılır, böylece offerwall'unuzla aynı olur.
- OpenAPI tanımı
Makine tarafından okunabilen bir openapi.json her alanı tanımlar; kod üreticileri ve yapay zeka kodlama ajanları için hazırdır.
Test edin, sonra yayına alın.
Gerçek kullanıcılar offerwall'unuzu görmeden önce kontrol etmeniz gereken her şey, panelinizdeki yerleşik araçlarla.
Test kullanıcısı olarak aç
Entegrasyon sekmesindeki Entegrasyon durumu bölümünde offerwall'unuzu owner-test kullanıcısı olarak açın. Test ziyaretleri kullanıcı olarak sayılmaz.
API'yi curl ile çağırın
Listeyi bir test kullanıcı ID'si ve tekliflerin yayında olduğu bir ülke için isteyin ve bir start_url'yi tarayıcıda açın.
Test postback'i gönder
Kullanıcıyı, durumu ve ödemeyi seçin; sunucunuzun tam olarak ne yanıt verdiğini yanıt kodu ve süresiyle görün. Test işlem ID'leri test_ ile başlar.
Normal bir bağlantıdan test edin
VPN'ler, proxy'ler, Tor ve bulut ağları engellenir; bu yüzden tekliflerin yayında olduğu bir ülkede, ev Wi-Fi'ında veya mobil veriyle test edin.
Yayın kontrol listesi
0 / 10 hazır
Yayına hazır. İlerlemeniz bu tarayıcıda kaydedilir.
Sık görülen hatalar, hızla çözülür.
Offers API'yi entegre ederken karşılaşabileceğiniz durumlar, nedenleri ve çözümleri.
400 invalid_countryBir parametre eksik veya hatalı: invalid_user_id, invalid_country veya invalid_device.
ÇözümHata kodunda adı geçen parametreyi düzeltin.
401 invalid_api_keyAnahtar eksik, hatalı veya değiştirilmiş.
ÇözümAuthorization başlığında Bearer olarak gönderin ve Entegrasyon sekmesinden yeniden kopyalayın.
403 app_not_liveUygulama duraklatılmış ya da hesabınız onaylı veya aktif değil.
ÇözümBildirimlerinizi kontrol edin. user_blocked durumunda o kullanıcıya teklif göstermeyin.
429 rate_limitedBu uygulama için bir dakikada 600'den fazla istek.
ÇözümRetry-After'daki saniye kadar bekleyin ve her kullanıcının listesini 1 ila 5 dakika önbelleğe alın.
Empty offers listBu normal bir yanıttır: şu anda o kullanıcı için uygun teklif yok.
ÇözümKullanıcı dostu bir boş durum gösterin ve gönderdiğiniz ülkeyi ve cihazı kontrol edin.
VPN detected on start_urlTeklif sayfası açıldığında kullanıcı bir VPN, proxy veya bulut ağında.
ÇözümKullanıcıdan bunu kapatmasını isteyin. Sunucunuzdan gelen API istekleri kontrol edilmez.
Postback log shows 403 or 404Script'iniz postback'i reddetti veya URL yanlış.
ÇözümLog'daki URL'yi bir tarayıcıda açın ve hash kodunuzu kontrol edin.
Postback log shows a timeoutScript'inizin yanıt vermesi 6 saniyeden uzun sürüyor.
ÇözümÖnce 200 ile yanıt verin, yavaş işleri arka planda çalıştırın.
Postback log shows 301 or 302URL'niz yönlendirme yapıyor, örneğin http'den https'e.
ÇözümSon URL'yi kullanın. Postback'ler yönlendirmeleri takip etmez.
Eşleşme yok. Tam listeyi belgelerde görün veya bize ulaşın.
Bir bakışta
- Endpoint
- GET https://api.moonetix.com/v1/offers
- Kimlik doğrulama
- Bearer API anahtarı, uygulama başına bir tane, yalnızca sunucu tarafında
- Zorunlu parametreler
- user_id, country ve device ya da ua
- İstek sınırı
- Her uygulama için dakikada en fazla 600 istek
- Biçim
- OpenAPI tanımıyla JSON
- Fiyat
- Onaylı yayıncılar için ücretsiz
Diğer entegrasyonlar
- Web sitesiBir link, bir iframe veya yüzen bir Earn düğmesi. SDK gerekmez.
- Android SDKKotlin ve Java uygulamaları için native bir offerwall ekranı.
- iOS SDKSwift, SwiftUI ve Objective-C için native bir offerwall.
- Unity SDKC# ile Android ve iOS oyunları için ödüllü teklifler.
- Flutter SDKAndroid ve iOS için tek bir Dart eklentisi.
- React Native SDKReact Native ve Expo uygulamaları için, TypeScript tipleriyle.
- Tüm entegrasyonlarOnları yan yana karşılaştırın.
Offers API soruları
Geliştiricilerin Offers API'yi eklemeden önce sordukları.
Bir yerde mi takıldınız? Bize ulaşın
Offerwall yerine Offers API'yi ne zaman kullanmalıyım?
En hızlı yayına geçmek için offerwall linkini kullanın. Teklifleri kendi sitenizde veya uygulamanızda, kendi tasarımınızla, örneğin diğer kaynaklardan gelen tekliflerin yanında veya kendi ödül mağazanızda göstermek istediğinizde Offers API'yi kullanın.
Offers API'yi bir tarayıcıdan veya mobil uygulamadan çağırabilir miyim?
Hayır. Yalnızca sunucunuzdan çağırın, çünkü istek API anahtarınızı taşır. Anahtar sızarsa Entegrasyon sekmesinde yeni bir tane oluşturun; eskisi hemen çalışmayı bırakır.
Hangi ülkeyi göndermeliyim?
Kullanıcının gerçekte bulunduğu ülke, US gibi iki harfli bir kod olarak. Teklifler ve ödüller buna bağlıdır; ülke ve cihaz, kullanıcı bir teklifi başlattığında yeniden kontrol edilir.
Ödüller offerwall'dakinden farklı mı?
Hayır. API, offerwall'unuzla aynı teklifleri aynı ödüllerle döndürür ve tamamlanan her adım sunucunuza aynı imzalı postback ile ulaşır.
İstek sınırı var mı?
Evet, her uygulama için dakikada en fazla 600 istek. Listeyi sık gösteriyorsanız her kullanıcı için kısa bir süre önbelleğe alın.
Aynı anahtar başka bir şey için de çalışıyor mu?
Evet. Bir uygulamanın API anahtarı Reporting API ve mobil SDK session'ları için de çalışır.
Trafiğinizi kazanca dönüştürün.
Ücretsiz bir yayıncı hesabı oluşturun ve kullanıcılarınızın web sitenizde, uygulamanızda, oyununuzda veya topluluğunuzda tamamladığı her tekliften kazanın.