Offers API. Su diseño, nuestras ofertas.
Obtenga las ofertas de cada usuario en JSON, con imágenes, pasos y recompensas ya en su moneda, y muéstrelas en sus propias tarjetas, junto a su propio contenido. Las recompensas llegan por postback, igual que con el offerwall.
- JSONREST sobre HTTPS
- 600Solicitudes por minuto
- OpenAPIEspecificación incluida
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"Comience en tres pasos.
Copie el código, reemplace los marcadores con los valores de su panel en Offerwalls, su offerwall, Integration, y haga pruebas antes de lanzar.
-
Solicite las ofertas de un usuario
Llame a la API desde su servidor con la clave de API de su app, el ID de usuario, el país en el que está el usuario y su dispositivo o user agent. La lista excluye las ofertas que el usuario ya completó o que todavía no puede volver a hacer.
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() -
Muéstrelas con su propio diseño
Cada oferta incluye su título, imagen, pasos y la recompensa en su moneda. Muéstrelas como prefiera y envíe al usuario al start_url de la oferta cuando elija una. La página de la oferta se abre en Moonetix y desde ahí lo lleva al anunciante.
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, })); } -
Acredite las recompensas con el postback
Cada recompensa llega a su servidor como un postback firmado. Verifique el hash, sume la recompensa una sola vez por ID de transacción y retírela si un postback posterior la revierte. Los postbacks fallidos se reintentan hasta 5 veces.
Panel, pestaña 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/..."
}
- Crear una cuenta+325
- Llegue al nivel 10+650
Del JSON a su diseño
Cada oferta llega lista para mostrarse, con sus pasos y recompensas ya en su moneda.
Lo que le ofrece la API
- Ofertas por usuario
Las ofertas se adaptan al país y al dispositivo que envía, y se excluyen las que el usuario ya completó.
- Recompensas en su moneda
Cada recompensa ya está calculada con su tasa de conversión, el reparto con el usuario, el redondeo y cualquier bonificación activa.
- Pasos e imágenes
Las ofertas de varios pasos muestran cada paso con su propia recompensa, para que pueda indicar exactamente qué se paga.
- Sub IDs
Envíe hasta cinco valores propios. Se agregan a cada start_url y vuelven en el postback.
- Las ofertas ocultas siguen ocultas
Las ofertas que oculte en la página Offers también se excluyen de la API, para que coincida con su offerwall.
- Especificación OpenAPI
Un archivo openapi.json legible por máquinas describe cada campo, listo para generadores de código y agentes de programación con IA.
Pruébelo y luego publíquelo.
Todo lo que necesita verificar antes de que los usuarios reales vean su offerwall, con las herramientas integradas en su panel.
Open as a test user
En Integration status, en la pestaña Integration, abra su offerwall como el usuario owner-test. Las visitas de prueba no cuentan como usuarios.
Llame a la API con curl
Solicite la lista para un ID de usuario de prueba y un país donde haya ofertas activas, y abra un start_url en un navegador.
Send a test postback
Elija el usuario, el estado y el pago, y vea exactamente qué respondió su servidor, con el código de respuesta y el tiempo. Los ID de transacción de prueba empiezan con test_.
Pruebe desde una conexión normal
Las VPN, los proxies, Tor y las redes en la nube están bloqueados, así que pruebe con el Wi-Fi de su casa o con datos móviles, en un país donde haya ofertas activas.
Lista de verificación para el lanzamiento
0 de 10 listos
Listo para lanzar. Su progreso se guarda en este navegador.
Errores comunes, resueltos rápido.
Lo que puede encontrar al integrar la Offers API, qué lo causa y cómo solucionarlo.
400 invalid_countryFalta un parámetro o es incorrecto: invalid_user_id, invalid_country o invalid_device.
SoluciónCorrija el parámetro indicado en el código de error.
401 invalid_api_keyLa clave falta, es incorrecta o fue reemplazada.
SoluciónEnvíela en el encabezado Authorization como Bearer y vuelva a copiarla desde la pestaña Integration.
403 app_not_liveLa app está en pausa, o su cuenta no está aprobada o activa.
SoluciónRevise sus notificaciones. Con user_blocked, no muestre ofertas a ese usuario.
429 rate_limitedMás de 600 solicitudes en un minuto para esta app.
SoluciónEspere los segundos que indica Retry-After y guarde en caché la lista de cada usuario de 1 a 5 minutos.
Empty offers listEs una respuesta normal: no hay nada disponible para ese usuario en este momento.
SoluciónMuestre un estado vacío amigable y revise el país y el dispositivo que envía.
VPN detected on start_urlEl usuario está en una VPN, un proxy o una red en la nube cuando se abre la página de la oferta.
SoluciónPida al usuario que lo desactive. Las solicitudes a la API desde su servidor no se verifican.
Postback log shows 403 or 404Su script rechazó el postback, o la URL es incorrecta.
SoluciónAbra en un navegador la URL que aparece en el registro y revise su código de hash.
Postback log shows a timeoutSu script tarda más de 6 segundos en responder.
SoluciónResponda primero con 200 y ejecute las tareas lentas en segundo plano.
Postback log shows 301 or 302Su URL redirige, por ejemplo de http a https.
SoluciónUse la URL final. Los postbacks no siguen redirecciones.
Sin resultados. Vea la lista completa en la documentación o contáctenos.
En resumen
- Endpoint
- GET https://api.moonetix.com/v1/offers
- Autenticación
- Clave de API Bearer, una por app, solo del lado del servidor
- Parámetros obligatorios
- user_id, country y device o ua
- Límite de solicitudes
- Hasta 600 solicitudes por minuto por app
- Formato
- JSON, con una descripción OpenAPI
- Precio
- Gratuito para publishers aprobados
Otras integraciones
- Sitio webUn enlace, un iframe o un botón flotante Earn. No necesita SDK.
- SDK de AndroidUna pantalla nativa de offerwall para apps en Kotlin y Java.
- SDK de iOSUn offerwall nativo para Swift, SwiftUI y Objective-C.
- SDK de UnityOfertas con recompensa para juegos de Android e iOS, desde C#.
- SDK de FlutterUn solo plugin de Dart para Android e iOS.
- SDK de React NativePara apps de React Native y Expo, con tipos de TypeScript.
- Todas las integracionesCompárelas lado a lado.
Preguntas sobre la Offers API
Lo que preguntan los desarrolladores antes de agregar la Offers API.
¿Se quedó atascado? Contáctenos
¿Cuándo debo usar la Offers API en lugar del offerwall?
Use el enlace del offerwall para empezar lo más rápido posible. Use la Offers API cuando quiera las ofertas dentro de su propio sitio o app, con su propio diseño, por ejemplo junto a ofertas de otras fuentes o en su propia tienda de recompensas.
¿Puedo llamar a la Offers API desde un navegador o una app móvil?
No. Llámela solo desde su servidor, porque la solicitud lleva su clave de API. Si la clave llegara a filtrarse, cree una nueva en la pestaña Integration y la anterior dejará de funcionar de inmediato.
¿Qué país debo enviar?
El país en el que realmente está el usuario, como código de dos letras, por ejemplo US. Las ofertas y las recompensas dependen de él, y el país y el dispositivo se verifican de nuevo cuando el usuario inicia una oferta.
¿Las recompensas son diferentes a las del offerwall?
No. La API devuelve las mismas ofertas que su offerwall, con las mismas recompensas, y cada paso completado llega a su servidor mediante el mismo postback firmado.
¿Hay un límite de solicitudes?
Sí, hasta 600 solicitudes por minuto por app. Guarde la lista en caché por poco tiempo para cada usuario si la muestra con frecuencia.
¿La misma clave sirve para algo más?
Sí. La clave de API de una app también sirve para la Reporting API y para las sesiones de los SDK móviles.
Siga explorando.
Convierta su tráfico en ganancias.
Cree una cuenta gratuita de publisher y gane con cada oferta que sus usuarios completen en su sitio web, app, juego o comunidad.