Offers API. Votre design, nos offres.
Récupérez les offres de chaque utilisateur en JSON, avec images, étapes et récompenses déjà dans votre monnaie, et affichez-les dans vos propres cartes, à côté de votre contenu. Les récompenses arrivent par postback, comme avec l’offerwall.
- JSONREST via HTTPS
- 600Requêtes par minute
- OpenAPISpécification incluse
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"En ligne en trois étapes.
Copiez le code, remplacez les espaces réservés par les valeurs de votre tableau de bord sous Offerwalls, votre offerwall, Intégration, et testez avant le lancement.
-
Demander les offres pour un utilisateur
Appelez l’API depuis votre serveur avec la clé API de votre app, l’ID utilisateur, le pays où se trouve l’utilisateur, et son appareil ou son user agent. La liste exclut les offres que l’utilisateur a déjà terminées ou ne peut pas encore refaire.
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() -
Affichez-les avec votre propre design
Chaque offre est fournie avec son titre, son image, ses étapes et la récompense dans votre monnaie. Affichez-les comme vous le souhaitez, et envoyez l’utilisateur vers le start_url de l’offre quand il en choisit une. La page de l’offre s’ouvre sur Moonetix et le redirige ensuite vers l’annonceur.
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, })); } -
Créditez les récompenses avec le postback
Chaque récompense arrive sur votre serveur sous forme de postback signé. Vérifiez le hash, ajoutez la récompense une seule fois par ID de transaction, et reprenez-la si un postback ultérieur l’annule. Les postbacks échoués sont relancés jusqu’à 5 fois.
Tableau de bord, onglet 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/..."
}
- Créer un compte+325
- Atteindre le niveau 10+650
Du JSON à votre design
Chaque offre arrive prête à afficher, avec ses étapes et ses récompenses déjà dans votre monnaie.
Ce que l’API vous fournit
- Offres par utilisateur
Les offres sont adaptées au pays et à l’appareil que vous envoyez, et celles qu’un utilisateur a déjà terminées sont exclues.
- Des récompenses dans votre monnaie
Chaque récompense est déjà calculée avec votre taux de conversion, la part de l’utilisateur, l’arrondi et tout bonus en cours.
- Étapes et images
Les offres en plusieurs étapes listent chaque étape avec sa propre récompense, vous pouvez donc montrer exactement ce qui rapporte.
- Sub IDs
Envoyez jusqu’à cinq valeurs personnalisées. Elles sont ajoutées à chaque start_url et reviennent dans le postback.
- Les offres masquées restent masquées
Les offres que vous masquez sur la page "Offres" sont aussi exclues de l’API, qui correspond ainsi à votre offerwall.
- Spécification OpenAPI
Un fichier openapi.json lisible par machine décrit chaque champ, prêt pour les générateurs de code et les agents de codage IA.
Testez, puis lancez.
Tout ce que vous devez vérifier avant que de vrais utilisateurs voient votre offerwall, avec les outils intégrés à votre tableau de bord.
Ouvrir en tant qu’utilisateur test
Dans "État de l’intégration" de l’onglet "Intégration", ouvrez votre offerwall en tant qu’utilisateur owner-test. Les visites de test ne sont pas comptées comme des utilisateurs.
Appeler l’API avec curl
Demandez la liste pour un ID utilisateur de test et un pays où des offres sont disponibles, et ouvrez un start_url dans un navigateur.
Envoyer un postback de test
Choisissez l’utilisateur, le statut et le paiement, et voyez exactement ce que votre serveur a répondu, avec le code de réponse et le temps. Les ID de transaction de test commencent par test_.
Testez depuis une connexion normale
Les VPN, proxys, Tor et réseaux cloud sont bloqués : testez donc en Wi-Fi domestique ou en données mobiles, dans un pays où des offres sont disponibles.
Checklist de lancement
0 sur 10 prêts
Prêt pour le lancement. Votre progression est enregistrée dans ce navigateur.
Erreurs courantes, vite corrigées.
Ce que vous pouvez rencontrer en intégrant l’Offers API, la cause et la solution.
400 invalid_countryUn paramètre est manquant ou incorrect : invalid_user_id, invalid_country ou invalid_device.
SolutionCorrigez le paramètre indiqué dans le code d’erreur.
401 invalid_api_keyLa clé est absente, incorrecte ou a été remplacée.
SolutionEnvoyez-la dans l’en-tête Authorization en tant que Bearer, et copiez-la à nouveau depuis l’onglet "Intégration".
403 app_not_liveL’app est en pause, ou votre compte n’est pas approuvé ou actif.
SolutionConsultez vos notifications. Avec user_blocked, ne montrez pas d’offres à cet utilisateur.
429 rate_limitedPlus de 600 requêtes en une minute pour cette app.
SolutionAttendez le nombre de secondes indiqué par Retry-After, et mettez en cache la liste de chaque utilisateur pendant 1 à 5 minutes.
Empty offers listC’est une réponse normale : rien n’est disponible pour cet utilisateur pour le moment.
SolutionAffichez un état vide convivial, et vérifiez le pays et l’appareil que vous envoyez.
VPN detected on start_urlL’utilisateur utilise un VPN, un proxy ou un réseau cloud quand la page de l’offre s’ouvre.
SolutionDemandez à l’utilisateur de le désactiver. Les requêtes API envoyées depuis votre serveur ne sont pas vérifiées.
Postback log shows 403 or 404Votre script a rejeté le postback, ou l’URL est incorrecte.
SolutionOuvrez l’URL du journal dans un navigateur et vérifiez votre code de hash.
Postback log shows a timeoutVotre script met plus de 6 secondes à répondre.
SolutionRépondez d’abord avec 200, et exécutez les tâches lentes en arrière-plan.
Postback log shows 301 or 302Votre URL redirige, par exemple de http vers https.
SolutionUtilisez l’URL finale. Les postbacks ne suivent pas les redirections.
Aucun résultat. Consultez la liste complète dans la documentation ou contactez-nous.
En bref
- Endpoint
- GET https://api.moonetix.com/v1/offers
- Authentification
- Clé API Bearer, une par app, côté serveur uniquement
- Paramètres obligatoires
- user_id, country, et device ou ua
- Limite de requêtes
- Jusqu’à 600 requêtes par minute pour chaque app
- Format
- JSON, avec une description OpenAPI
- Prix
- Gratuit pour les éditeurs approuvés
Autres intégrations
- Site webUn lien, un iframe ou un bouton Earn flottant. Aucun SDK nécessaire.
- SDK AndroidUn écran d’offerwall natif pour les apps Kotlin et Java.
- SDK iOSUn offerwall natif pour Swift, SwiftUI et Objective-C.
- SDK UnityDes offres avec récompense pour les jeux Android et iOS, depuis C#.
- SDK FlutterUn seul plugin Dart pour Android et iOS.
- SDK React NativePour les apps React Native et Expo, avec les types TypeScript.
- Toutes les intégrationsComparez-les côte à côte.
Questions sur l’Offers API
Les questions des développeurs avant d’ajouter l’Offers API.
Un point bloquant ? Contactez-nous
Quand utiliser l’Offers API plutôt que l’offerwall ?
Utilisez le lien de l’offerwall pour être en ligne au plus vite. Utilisez l’Offers API quand vous voulez des offres dans votre propre site ou app, avec votre propre design, par exemple à côté d’offres d’autres sources ou dans votre propre boutique de récompenses.
Puis-je appeler l’Offers API depuis un navigateur ou une app mobile ?
Non. Appelez-la uniquement depuis votre serveur, car la requête contient votre clé API. En cas de fuite de la clé, créez-en une nouvelle dans l’onglet "Intégration" et l’ancienne cesse immédiatement de fonctionner.
Quel pays dois-je envoyer ?
Le pays où se trouve réellement l’utilisateur, sous forme de code à deux lettres comme US. Les offres et les récompenses en dépendent, et le pays et l’appareil sont à nouveau vérifiés quand l’utilisateur commence une offre.
Les récompenses sont-elles différentes de celles de l’offerwall ?
Non. L’API renvoie les mêmes offres que votre offerwall, avec les mêmes récompenses, et chaque étape terminée arrive sur votre serveur via le même postback signé.
Y a-t-il une limite de requêtes ?
Oui, jusqu’à 600 requêtes par minute pour chaque app. Si vous affichez souvent la liste, mettez-la brièvement en cache pour chaque utilisateur.
La même clé sert-elle à autre chose ?
Oui. La clé API d’une app fonctionne aussi pour la Reporting API et pour les sessions des SDK mobiles.
Transformez votre trafic en revenus.
Créez un compte éditeur gratuit et gagnez de l’argent sur chaque offre que vos utilisateurs terminent sur votre site web, votre app, votre jeu ou votre communauté.