Enregistrez votre application une fois

Dans la section Développeur de votre tableau de bord, vous enregistrez l'application qui répondra pour vos tâches : un nom, l'URL de vérification vers laquelle les participants sont envoyés, et un mode de signature. La signature repose soit sur un secret partagé affiché une seule fois à la création, soit sur une paire de clés Ed25519 si votre stack préfère les signatures à clé publique. Vous pouvez renouveler le secret partagé ou désactiver l'application à tout moment.

Ensuite, vous nommez les actions que l'application peut confirmer, jusqu'à vingt par application, chacune avec un libellé que votre équipe reconnaîtra dans l'éditeur. Le guide développeur Verified Actions documente tout l'échange pour la personne qui construit l'endpoint, avec une implémentation de référence à copier-coller. Il contient aussi un fichier de skill à donner à un agent de code IA pour qu'il écrive l'endpoint à votre place.

Rattachez une action à un giveaway

Dans l'éditeur de giveaway, ajoutez une tâche personnalisée, choisissez la méthode App Verified, puis sélectionnez l'application et l'action. À partir de là, elle se comporte comme n'importe quelle tâche du giveaway : elle a sa propre valeur en chances, s'affiche à côté des tâches du catalogue sur la page de participation, et montre aux participants le nom, l'icône et les instructions que vous lui avez donnés.

Votre application répond à une requête signée

Quand un participant démarre la tâche, ScopliDrop le redirige vers votre URL de vérification avec un jeton de requête signé qui nomme l'action à contrôler et un identifiant de participant qui relie la réponse à la tâche. Votre service connecte l'utilisateur avec son propre login, vérifie l'action dans ses propres données, puis renvoie le navigateur avec un oui ou un non signé.

Chaque requête ne vaut que pour une seule réponse. La réponse doit être signée avec la clé enregistrée, correspondre au participant pour lequel elle a été émise, et arriver dans sa fenêtre de validité, sinon elle est rejetée. Une réponse rejouée ou modifiée ne touche jamais une participation.

La tâche se valide toute seule

Un oui valide la tâche dès que le participant revient sur la page de participation, sans rien à contrôler de votre côté. Un non lui affiche un message clair qui nomme votre application, pour qu'il termine l'action et réessaie. Ensuite, le giveaway traite la participation comme n'importe quelle autre, jusqu'au tirage.

Pour vos développeurs, le tableau de bord garde un journal des derniers handshakes de l'application, avec un code de résultat précis sur chacun, y compris le code d'échec que votre application a pu joindre à un non. Une signature mal configurée ou une réponse expirée se repère d'un coup d'œil au lieu d'échouer en silence.