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
Offers APIREST, JSON
Terminal
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.

  1. 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.

    Terminal
    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"
  2. 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/..."
        }
      ]
    }
  3. 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.

    Macros y reintentos de postback

    Panel, pestaña Postback
    https://yoursite.com/postback?user={user_id}&tx={transaction_id}&status={status}&reward={reward}&hash={hash}
GET /v1/offers
{
  "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/..."
}
Su diseño
Nova QuestLlegue al nivel 10
  1. Crear una cuenta+325
  2. Llegue al nivel 10+650
Total975 monedasIniciar oferta

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.

  1. 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.

  2. 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.

  3. 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_.

  4. 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

Errores comunes, resueltos rápido.

Lo que puede encontrar al integrar la Offers API, qué lo causa y cómo solucionarlo.

  • 400 invalid_country

    Falta 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_key

    La 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_live

    La 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_limited

    Má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 list

    Es 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_url

    El 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 404

    Su 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 timeout

    Su 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 302

    Su URL redirige, por ejemplo de http a https.

    SoluciónUse la URL final. Los postbacks no siguen redirecciones.

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

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.

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.

Segmentación mundial
Más
Iniciar sesión