Offers API. Ihr Design, unsere Angebote.
Rufen Sie die Angebote für jeden Nutzer als JSON ab, mit Bildern, Schritten und Belohnungen bereits in Ihrer Währung, und zeigen Sie sie in Ihren eigenen Karten neben Ihren eigenen Inhalten. Belohnungen kommen per Postback, genau wie bei der Offerwall.
- JSONREST über HTTPS
- 600Anfragen pro Minute
- OpenAPISpezifikation inklusive
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"Live in drei Schritten.
Kopieren Sie den Code, ersetzen Sie die Platzhalter durch die Werte aus Ihrem Dashboard unter Offerwalls, Ihre Offerwall, Integration, und testen Sie vor dem Start.
-
Angebote für einen Nutzer abrufen
Rufen Sie die API von Ihrem Server aus auf, mit dem API-Schlüssel Ihrer App, der Nutzer-ID, dem Land, in dem sich der Nutzer befindet, und seinem Gerät oder User-Agent. Die Liste lässt Angebote weg, die der Nutzer bereits abgeschlossen hat oder noch nicht erneut machen kann.
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() -
Zeigen Sie sie in Ihrem eigenen Design
Jedes Angebot kommt mit Titel, Bild, Schritten und der Belohnung in Ihrer Währung. Stellen Sie sie dar, wie Sie möchten, und schicken Sie den Nutzer zur start_url des Angebots, wenn er eines auswählt. Die Angebotsseite öffnet sich auf Moonetix und leitet ihn von dort zum Werbetreibenden weiter.
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, })); } -
Belohnungen per Postback gutschreiben
Jede Belohnung erreicht Ihren Server als signierter Postback. Prüfen Sie den Hash, schreiben Sie die Belohnung pro Transaktions-ID einmal gut und nehmen Sie sie zurück, wenn ein späterer Postback sie rückbucht. Fehlgeschlagene Postbacks werden bis zu 5 Mal wiederholt.
Dashboard, 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/..."
}
- Konto erstellen+325
- Level 10 erreichen+650
Von JSON zu Ihrem Design
Jedes Angebot kommt fertig zur Anzeige, mit seinen Schritten und Belohnungen bereits in Ihrer Währung.
Was die API Ihnen liefert
- Angebote pro Nutzer
Die Angebote passen zu dem Land und Gerät, das Sie senden, und solche, die ein Nutzer bereits abgeschlossen hat, werden weggelassen.
- Belohnungen in Ihrer Währung
Jede Belohnung ist bereits mit Ihrem Umrechnungskurs, Nutzeranteil, Ihrer Rundung und jedem laufenden Bonus berechnet.
- Schritte und Bilder
Mehrstufige Angebote listen jeden Schritt mit eigener Belohnung auf, sodass Sie genau zeigen können, was sich auszahlt.
- Sub IDs
Senden Sie bis zu fünf eigene Werte. Sie werden an jede start_url angehängt und kommen im Postback zurück.
- Ausgeblendete Angebote bleiben ausgeblendet
Angebote, die Sie auf der Seite Offers ausblenden, fehlen auch in der API, sodass sie Ihrer Offerwall entspricht.
- OpenAPI-Spezifikation
Eine maschinenlesbare openapi.json beschreibt jedes Feld, bereit für Codegeneratoren und KI-Coding-Agenten.
Erst testen, dann starten.
Alles, was Sie prüfen sollten, bevor echte Nutzer Ihre Offerwall sehen, mit den Tools in Ihrem Dashboard.
Open as a test user
Öffnen Sie unter Integration status im Tab Integration Ihre Offerwall als Nutzer owner-test. Testbesuche werden nicht als Nutzer gezählt.
API mit curl aufrufen
Fordern Sie die Liste für eine Test-Nutzer-ID und ein Land an, in dem Angebote laufen, und öffnen Sie eine start_url in einem Browser.
Send a test postback
Wählen Sie Nutzer, Status und Auszahlung und sehen Sie genau, was Ihr Server geantwortet hat, mit Antwortcode und Zeit. Test-Transaktions-IDs beginnen mit test_.
Über eine normale Verbindung testen
VPNs, Proxys, Tor und Cloud-Netzwerke werden blockiert. Testen Sie daher über Ihr WLAN zu Hause oder mobile Daten, in einem Land, in dem Angebote laufen.
Checkliste vor dem Start
0 von 10 erledigt
Startklar. Ihr Fortschritt wird in diesem Browser gespeichert.
Häufige Fehler, schnell behoben.
Was Ihnen bei der Integration der Offers API begegnen kann, woran es liegt und wie Sie es beheben.
400 invalid_countryEin Parameter fehlt oder ist falsch: invalid_user_id, invalid_country oder invalid_device.
LösungKorrigieren Sie den Parameter, der im Fehlercode genannt wird.
401 invalid_api_keyDer Schlüssel fehlt, ist falsch oder wurde ersetzt.
LösungSenden Sie ihn im Authorization-Header als Bearer und kopieren Sie ihn erneut aus dem Tab Integration.
403 app_not_liveDie App ist pausiert, oder Ihr Konto ist nicht freigegeben oder nicht aktiv.
LösungPrüfen Sie Ihre Benachrichtigungen. Zeigen Sie diesem Nutzer bei user_blocked keine Angebote an.
429 rate_limitedMehr als 600 Anfragen pro Minute für diese App.
LösungWarten Sie die Sekunden aus Retry-After ab und cachen Sie die Liste jedes Nutzers für 1 bis 5 Minuten.
Empty offers listDas ist eine normale Antwort: Für diesen Nutzer ist gerade nichts verfügbar.
LösungZeigen Sie einen freundlichen Leerzustand an und prüfen Sie Land und Gerät, die Sie senden.
VPN detected on start_urlDer Nutzer nutzt ein VPN, einen Proxy oder ein Cloud-Netzwerk, wenn sich die Angebotsseite öffnet.
LösungBitten Sie den Nutzer, es auszuschalten. API-Anfragen von Ihrem Server werden nicht geprüft.
Postback log shows 403 or 404Ihr Skript hat den Postback abgelehnt, oder die URL ist falsch.
LösungÖffnen Sie die URL aus dem Log in einem Browser und prüfen Sie Ihren Hash-Code.
Postback log shows a timeoutIhr Skript braucht länger als 6 Sekunden für die Antwort.
LösungAntworten Sie zuerst mit 200 und erledigen Sie langsame Aufgaben im Hintergrund.
Postback log shows 301 or 302Ihre URL leitet weiter, zum Beispiel von http auf https.
LösungVerwenden Sie die endgültige URL. Postbacks folgen keinen Weiterleitungen.
Kein Treffer. Die vollständige Liste finden Sie in den Docs, oder kontaktieren Sie uns.
Auf einen Blick
- Endpunkt
- GET https://api.moonetix.com/v1/offers
- Authentifizierung
- Bearer-API-Schlüssel, einer pro App, nur serverseitig
- Pflichtparameter
- user_id, country und device oder ua
- Rate Limit
- Bis zu 600 Anfragen pro Minute für jede App
- Format
- JSON, mit OpenAPI-Beschreibung
- Preis
- Kostenlos für freigegebene Publisher
Weitere Integrationen
- WebsiteEin Link, ein iframe oder ein schwebender Earn-Button. Kein SDK nötig.
- Android SDKEin nativer Offerwall-Bildschirm für Kotlin- und Java-Apps.
- iOS SDKEine native Offerwall für Swift, SwiftUI und Objective-C.
- Unity SDKAngebote mit Belohnung für Android- und iOS-Spiele, aus C#.
- Flutter SDKEin Dart-Plugin für Android und iOS.
- React Native SDKFür React-Native- und Expo-Apps, mit TypeScript-Typen.
- Alle IntegrationenVergleichen Sie sie direkt nebeneinander.
Fragen zur Offers API
Was Entwickler fragen, bevor sie die Offers API einbinden.
Kommen Sie nicht weiter? Kontaktieren Sie uns
Wann sollte ich die Offers API statt der Offerwall verwenden?
Mit dem Offerwall-Link sind Sie am schnellsten live. Nutzen Sie die Offers API, wenn Sie Angebote in Ihrer eigenen Website oder App in Ihrem eigenen Design zeigen möchten, zum Beispiel neben Angeboten aus anderen Quellen oder in Ihrem eigenen Prämien-Shop.
Kann ich die Offers API aus einem Browser oder einer mobilen App aufrufen?
Nein. Rufen Sie sie nur von Ihrem Server auf, denn die Anfrage enthält Ihren API-Schlüssel. Falls der Schlüssel jemals in falsche Hände gerät, erstellen Sie im Tab Integration einen neuen, und der alte funktioniert sofort nicht mehr.
Welches Land sollte ich senden?
Das Land, in dem sich der Nutzer tatsächlich befindet, als zweistelliger Code wie US. Angebote und Belohnungen hängen davon ab, und Land und Gerät werden erneut geprüft, wenn der Nutzer ein Angebot startet.
Unterscheiden sich die Belohnungen von denen der Offerwall?
Nein. Die API liefert dieselben Angebote wie Ihre Offerwall, mit denselben Belohnungen, und jeder abgeschlossene Schritt erreicht Ihren Server über denselben signierten Postback.
Gibt es ein Rate Limit?
Ja, bis zu 600 Anfragen pro Minute für jede App. Cachen Sie die Liste pro Nutzer für kurze Zeit, wenn Sie sie oft anzeigen.
Funktioniert derselbe Schlüssel auch für etwas anderes?
Ja. Der API-Schlüssel einer App funktioniert auch für die Reporting API und für Sessions der mobilen SDKs.
Machen Sie Ihren Traffic zu Einnahmen.
Erstellen Sie ein kostenloses Publisher-Konto und verdienen Sie an jedem Angebot, das Ihre Nutzer auf Ihrer Website, in Ihrer App, Ihrem Spiel oder Ihrer Community abschließen.