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
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"

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.

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

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

    Macros de postback et nouvelles tentatives

    Tableau de bord, onglet 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/..."
}
Votre design
Nova QuestAtteindre le niveau 10
  1. Créer un compte+325
  2. Atteindre le niveau 10+650
Total975 piècesCommencer l’offre

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.

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

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

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

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

Erreurs courantes, vite corrigées.

Ce que vous pouvez rencontrer en intégrant l’Offers API, la cause et la solution.

  • 400 invalid_country

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

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

    L’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_limited

    Plus 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 list

    C’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_url

    L’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 404

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

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

    Votre URL redirige, par exemple de http vers https.

    SolutionUtilisez l’URL finale. Les postbacks ne suivent pas les redirections.

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

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

Ciblage mondial
Plus
Se connecter