Skip to main content
La récompense est placée sous séquestre lors de la publication de la bounty, les travailleurs soumettent une preuve du travail effectué, et chaque soumission acceptée est payée jusqu’à ce que toutes les places de gagnants soient pourvues. Utilisez l’API Bounties pour créer et publier une bounty, lister les bounties d’un compte pour le reporting ou les tableaux de bord, lister les bounties sur lesquelles un utilisateur peut travailler ou auxquelles il a participé, et récupérer une bounty par son ID.

Endpoints

Attributs

string
requis
ID de la bounty, préfixé par bnty_.
string[]
requis
Les formes de livrables acceptées par cette bounty. Chaque bounty accepte n’importe quelle combinaison de content_url (liens publiés) et media (fichiers importés), sauf les bounties data_capture, dont la preuve consiste en des clips enregistrés dans l’app Whop qui s’accumulent sur la tentative.Options disponibles : content_url, media, data_capture
integer
requis
Soumissions acceptées jusqu’à présent.
integer
requis
Nombre de soumissions pouvant être acceptées (places de gagnants).
integer
requis
Nombre de places de gagnants qu’un même travailleur peut remporter. 1 par défaut. Les victoires plus les preuves en attente d’examen ne dépassent jamais ce nombre, et un travailleur ne mène qu’une tentative à la fois. Ne peut pas dépasser accepted_submissions_limit.
object[]
requis
Livestreams de preuve actuellement en direct sur cette bounty, du plus récent au plus ancien — des travailleurs qui diffusent leurs tentatives. Vide lorsque rien n’est en direct.

Propriétés

string
requis
ID du flux de livestream.
object | null
requis
Utilisateur qui anime le livestream de preuve — le travailleur qui diffuse sa tentative. null si le compte de l’hôte n’existe plus.

Propriétés

string
requis
ID de l’utilisateur, préfixé par user_.
string | null
requis
Nom d’affichage.
object
requis
Conteneur de l’avatar. Son url est toujours présente et correspond à une image générée par défaut lorsque l’utilisateur n’a défini aucune photo.

Propriétés

string
requis
URL de l’image de l’avatar. Toujours présente. Il s’agit d’une image générée par défaut lorsque l’utilisateur n’a défini aucune photo.
string
requis
Nom d’utilisateur public.
string
requis
Titre d’affichage du livestream de preuve.
number
requis
Ce que gagne un parrain par soumission acceptée lorsque le travailleur est arrivé via son lien d’affiliation, en unités monétaires entières, au taux de frais standard de la plateforme. Prélevé sur la récompense du travailleur après frais plutôt qu’ajouté en plus. 0 lorsque la bounty ne verse aucune part d’affiliation, y compris pour les bounties liées à aucun compte, qui ne peuvent pas enregistrer de parrainage.
string[]
requis
Pays dont les résidents peuvent travailler sur la bounty, sous forme de codes ISO 3166 alpha-2. Vide signifie dans le monde entier.
integer
requis
Soumissions livrées et en attente d’examen. Un sous-ensemble de unresolved_submissions_count, qui compte également les tentatives encore en cours.
number
requis
Budget brut total engagé pour la bounty : gross_reward_amount multiplié par accepted_submissions_limit.
string | null
requis
Ce que l’auteur de la publication souhaite que le travail accomplisse, déclaré une seule fois lors de la création. null pour les bounties créées avant le déploiement de cette taxonomie.Options disponibles : clipping, post_engagement, owned_account_growth, ugc_content, local_activation, data_capture, other
string | null
requis
Date à laquelle l’annulation a été demandée, sous forme d’horodatage ISO 8601. Sur une bounty closed, cela signifie que l’annulation est en attente : les soumissions sont arrêtées et la bounty est annulée une fois les soumissions en cours résolues. Sur une bounty canceled, cela enregistre la date de la demande d’annulation. null lorsqu’aucune annulation n’a jamais été demandée.
object | null
requis
Le cahier des charges technique selon lequel les images doivent être enregistrées. Présent uniquement sur les bounties data_capture ; null pour tous les autres types d’objectifs.

Propriétés

string
requis
La convention de nommage des fichiers importés, construite à partir des champs de métadonnées requis.
object
requis
Exigences d’enregistrement de la centrale inertielle (IMU).

Propriétés

string
requis
Unités des canaux de mouvement de l’appareil, sous forme de chaîne compacte clé=unité.
string
requis
Unités du canal du magnétomètre.
number
requis
Fréquence d’échantillonnage IMU minimale soutenue, en hertz, pour qu’un clip passe la validation.
integer
requis
Fréquence d’échantillonnage IMU cible, en hertz.
number
requis
Fréquence d’échantillonnage IMU minimale tolérée, en hertz, pendant la période de préchauffage.
integer
requis
Période de démarrage, en nanosecondes, pendant laquelle la fréquence de préchauffage assouplie s’applique.
integer
requis
Version du schéma que le client doit indiquer sur le manifeste de capture qu’il importe.
integer
requis
Durée minimale d’un clip, en secondes.
integer
requis
Total d’images vérifiées qu’une soumission doit accumuler sur l’ensemble de ses clips avant de pouvoir être soumise, en secondes. Toujours un nombre entier d’heures.
string[]
requis
Champs de métadonnées qu’une soumission doit fournir, correspondant à l’objet metadata de l’API des soumissions.
boolean
requis
Indique si chaque clip doit être un enregistrement ininterrompu plutôt que des segments assemblés.
object
requis
Exigences d’enregistrement vidéo.

Propriétés

integer
requis
Débit moyen maximal acceptable, en mégabits par seconde.
integer
requis
Débit moyen minimal acceptable, en mégabits par seconde.
integer
requis
Débit moyen d’encodage recommandé, en mégabits par seconde.
string
requis
Objectif physique à utiliser pour l’enregistrement.
string[]
requis
Codecs vidéo acceptés, par ordre de préférence.
boolean
requis
Indique si le client doit également écrire la marque et le modèle de la caméra dans les métadonnées du conteneur vidéo. Lorsque false, ce sont le manifeste de capture et le CSV d’export qui portent les métadonnées.
integer
requis
Fréquence d’images de capture cible.
integer
requis
Blocage le plus long entre deux images consécutives qu’un clip peut contenir avant que le client ne le rejette, en millisecondes. Chaque image est horodatée dans le journal des images, de sorte qu’un blocage reste alignable en aval — cette valeur limite le degré d’altération d’une capture, et non la régularité de son rythme.
integer
requis
Hauteur d’image requise en pixels — les images enregistrées doivent correspondre exactement.
integer
requis
Champ de vision horizontal minimal acceptable, en degrés.
string
requis
Orientation de l’appareil pour l’enregistrement.
integer
requis
Champ de vision horizontal préféré, en degrés.
string
requis
La manière dont le client doit configurer la stabilisation vidéo : off désactive l’EIS afin de préserver le mouvement brut pour l’extraction de pose, on l’exige, any conserve le réglage par défaut de l’appareil.Options disponibles : off, on, any
boolean
requis
Indique si la stabilisation matérielle/logicielle doit être activée. Vrai exactement lorsque stabilization_mode vaut on.
integer
requis
Largeur d’image requise en pixels — les images enregistrées doivent correspondre exactement.
string
requis
Date de création de la bounty, sous forme d’horodatage ISO 8601.
string
requis
Devise de tous les montants de la bounty, sous forme de code ISO 4217 en minuscules.Options disponibles : usd, sgd, inr, aud, brl, cad, dkk, eur, nok, gbp, sek, chf, hkd, huf, jpy, mxn, myr, pln, czk, nzd, aed, cop, ron, thb, bgn, idr, dop, php, try, krw, twd, vnd, pkr, clp, uyu, ars, zar, dzd, tnd, mad, kes, kwd, jod, all, xcd, amd, bsd, bhd, bob, bam, khr, crc, xof, egp, etb, gmd, ghs, gtq, gyd, ils, jmd, mop, mga, mur, mdl, mnt, nad, ngn, mkd, omr, pyg, pen, qar, rwf, sar, rsd, lkr, tzs, ttd, uzs, rub, cny, kzt, awg, hnl
integer
requis
Soumissions examinées et refusées.
string
requis
Instructions complètes de la tâche affichées aux travailleurs.
string | null
requis
Expérience dans laquelle se trouve le fil de discussion de la bounty, préfixée par exp_. Lisez ce champ — et non experience_id — pour ouvrir le fil : une bounty à l’échelle de la plateforme n’a pas d’expérience d’hébergement propre, mais sa discussion se trouve tout de même dans une expérience.
string | null
requis
Flux de forum contenant le fil de discussion de la bounty. null pour une bounty sans publication de forum.
string | null
requis
Publication de forum servant d’ancre au fil de discussion de la bounty. À lire avec discussion_experience_id pour adresser le fil. null pour une bounty sans publication de forum.
string | null
requis
Expérience dans laquelle la bounty est hébergée, préfixée par exp_. null pour les bounties à l’échelle de la plateforme ; peut appartenir à un compte différent de celui qui finance.
object | null
requis
Compte dont le solde finance la cagnotte de la bounty, ou null lorsqu’un utilisateur la finance personnellement. Peut différer du compte qui héberge experience_id.

Propriétés

string
requis
ID du compte, préfixé par biz_.
string
requis
Nom d’affichage du compte.
number
requis
Montant brut versé depuis la cagnotte de la bounty pour l’ensemble des soumissions acceptées — paiements aux travailleurs, frais de plateforme et parts d’affiliation confondus. Les pourboires et les récompenses des examinateurs sont exclus.
number
requis
Montant brut de la cagnotte de la bounty alloué par soumission acceptée, en unités monétaires entières.
object | null
requis
Compte qui héberge le forum de la bounty — celui dont la route et l’experience_id adressent son fil de discussion, et où se trouve son tableau de bord des soumissions. null pour une bounty à l’échelle de la plateforme sans hôte. Peut différer de funding_account.

Propriétés

string
requis
ID du compte, préfixé par biz_.
string | null
requis
URL de l’image du logo du compte. null lorsque le compte n’en a pas défini.
string
requis
Identifiant de route publique du compte, utilisé dans le chemin de la vitrine whop.com/\{route}.
string
requis
Nom d’affichage du compte.
integer | null
requis
Total d’images vérifiées qu’une soumission doit accumuler avant de pouvoir être soumise, en secondes. Toujours un nombre entier d’heures. Présent uniquement sur les bounties data_capture — c’est ce que rémunère net_reward_amount, donc les affichages de taux divisent par cette valeur. null pour tous les autres types d’objectifs.
number
requis
Ce qui est annoncé à un travailleur par soumission acceptée après les frais de plateforme, en unités monétaires entières. Le montant exact après frais, au taux de frais standard de la plateforme — un travailleur qui a verrouillé un taux différent, ou qui est arrivé via un lien d’affiliation, perçoit un montant différent.
object
requis
Utilisateur qui a publié la bounty — le propriétaire du compte lorsqu’elle est créée avec une clé API de compte.

Propriétés

string
requis
ID de l’utilisateur, préfixé par user_.
string | null
requis
Nom d’affichage.
object
requis
Conteneur de l’avatar. Son url est toujours présente et correspond à une image générée par défaut lorsque l’utilisateur n’a défini aucune photo.

Propriétés

string
requis
URL de l’image de l’avatar. Toujours présente. Il s’agit d’une image générée par défaut lorsque l’utilisateur n’a défini aucune photo.
string
requis
Nom d’utilisateur public.
string | null
requis
Fréquence à laquelle la planification crée une nouvelle bounty. Chaque occurrence est une bounty distincte ; l’originale n’est pas republiée.Options disponibles : once, hourly, daily, weekly, monthly
string | null
requis
Date de publication d’une bounty planifiée, sous forme d’horodatage ISO 8601. null une fois publiée, pour les bounties qui n’ont jamais été planifiées, et pour les brouillons en échec définitif mis de côté pour une replanification manuelle.
integer
requis
Capacité de gagnants non pourvue : accepted_submissions_limit moins accepted_submissions_count, ramenée à zéro au minimum. Ce n’est pas à lui seul un signal indiquant que la bounty accepte de nouvelles revendications — lisez status pour cela : seule une bounty open accepte de nouvelles soumissions.
string
requis
État du cycle de vie. Les bounties scheduled sont des brouillons non publiés, visibles par leur auteur et par les gestionnaires autorisés du compte ; les bounties open acceptent de nouvelles soumissions ; les bounties closed sont en ligne mais n’acceptent plus de nouvelles soumissions ; les bounties completed ont payé toutes les places de gagnants ; les bounties canceled se sont terminées avant que leurs places ne soient pourvues.Options disponibles : scheduled, open, closed, completed, canceled
string | null
requis
Date à laquelle les nouvelles soumissions ont cessé d’être acceptées, sous forme d’horodatage ISO 8601. Défini lorsqu’une annulation est demandée sur une bounty dont du travail est en cours, afin que les soumissions en cours puissent être résolues avant l’annulation de la bounty. null lorsque les soumissions n’ont jamais été arrêtées — y compris pour les bounties terminées qui ont simplement pourvu toutes les places de gagnants.
string
requis
Nom court de la tâche affiché aux travailleurs.
integer
requis
Soumissions toujours en attente d’un résultat : en cours ou en attente d’examen.
string
requis
Date de dernière mise à jour de la bounty, sous forme d’horodatage ISO 8601.
integer
requis
Nombre de places de gagnants que l’utilisateur authentifié a déjà remportées sur cette bounty. À comparer avec accepted_submissions_per_user_limit pour montrer à un travailleur ce qu’il lui reste. 0 lorsque la requête n’a pas d’utilisateur authentifié.
Bounty