Je hebt een API-sleutel nodig met
bounty:create en payout:transfer_funds, omdat er bij het plaatsen van een bounty geld wordt verplaatst. Voor het lezen van inzendingen is bounty:basic:read nodig.Een bounty plaatsen
POST /bounties heeft een title nodig, een description met de instructies die een worker volgt, en een gross_reward_amount.
Wat de beloning je kost
gross_reward_amount is in hele Amerikaanse dollars per geaccepteerde inzending, niet per bounty. accepted_submissions_limit bepaalt hoeveel inzendingen kunnen winnen en is standaard 1. Whop houdt het product van die twee in escrow, en dat totaal moet ten minste $5 zijn. Het voorbeeld hierboven houdt $100 in escrow.
Platformkosten en affiliate-aandelen worden van het brutobedrag afgehaald in plaats van erbovenop te komen, dus een beloning van $25 kost de financier $25.
Waar het geld vandaan komt
De pot wordt standaard gefinancierd uit het persoonlijke saldo van de aanroeper. Geefaccount_id mee om de pot in plaats daarvan te financieren uit het saldo van een account. Daarvoor heb je toestemming nodig om het geld van dat account te verplaatsen.
Waar de bounty staat
experience_id plaatst een bounty in een specifieke experience, openbaar voor een open bounty of privé voor een bounty op uitnodiging, en is vereist tenzij je account_id instelt. Wanneer je account_id instelt en de experience weglaat, komt de bounty in het openbare forum van dat account te staan.
Het doel aangeven
business_goal_type geeft aan wat het werk moet opleveren, en je geeft dit één keer op wanneer je de bounty aanmaakt. Het accepteert clipping, post_engagement, owned_account_growth, ugc_content, local_activation, data_capture of other.
capture_spec wordt alleen geaccepteerd wanneer het doel data_capture is. Met elk ander doel mislukt het verzoek.
Plannen en herhalen
Een bounty wordt gepubliceerd zodra je hem aanmaakt, tenzij jepublish_at instelt. Whop maakt hem dan aan als verborgen concept en financiert en publiceert hem op het tijdstip dat je hebt opgegeven. publish_at_timezone is vereist wanneer publish_at is ingesteld.
frequency maakt van een geplande bounty een terugkerende bounty. De standaardwaarde is once, het accepteert hourly, daily, weekly of monthly en geldt alleen in combinatie met publish_at. Elke herhaling is een aparte bounty met eigen inzendingen en een eigen escrow.
Een bounty bewerken
WatPATCH /bounties/{id} accepteert, hangt ervan af of de bounty al is gepubliceerd. Een gepland concept accepteert alles: de beloning, de winnaarsplekken, de planning en de inhoudsvelden.
Een gepubliceerde bounty accepteert alleen inhoud, namelijk title, description, allowed_country_codes en business_goal_type. Zelfs die worden geweigerd zodra de bounty geen pogingen meer accepteert, of zodra een inzending submitted of approved bereikt. De beloning, de winnaarsplekken en de planning liggen allemaal vast zodra een bounty is gepubliceerd.
accepted_submissions_per_user_limit beperkt hoeveel plekken één worker kan winnen. De standaardwaarde is 1, de waarde kan accepted_submissions_limit niet overschrijden, en een worker voert één poging tegelijk uit.
Inzendingen ontvangen
POST /bounty_submissions accepteert de bounty_id en een deliverable. Combineer urls, file_ids en een caption, met ten minste één link of één bestand. Whop weigert een lege deliverable. Bij een standaardbounty is deze ene aanroep de volledige flow voor de worker, en gaat de inzending direct ter beoordeling. Inzendingen vereisen gebruikersreferenties, dus met een Account API-sleutel kun je er geen maken.
allowed_country_codes beperkt wie aan een bounty kan werken. Het accepteert ISO 3166 alpha-2-codes. Een lege lijst betekent wereldwijd.
Een worker kan de eigen poging intrekken met DELETE /bounty_submissions/{id}. Alleen de worker die de poging is gestart kan dat, en een Account API-sleutel kan het niet namens hem doen.
Doelen die je integratie niet kan voltooien
Bij twee doeltypen wordt het bewijs buiten de API verzameld. Maak bij eendata_capture-bounty de inzending aan zonder deliverable: daarmee start een geclaimde poging waarvan de clips server-side worden verzameld. Bewijs voor een livestreambounty loopt via een omgeving die de openbare API niet beschikbaar stelt. Je integratie kan deze bounties plaatsen en de wachtrijen ervan lezen, maar een worker rondt de poging af in Whop.
De wachtrij beoordelen
Lees inzendingen metGET /bounty_submissions, gefilterd op bounty_id en optioneel op status.
Bounties versturen geen webhooks. Om uitkomsten in je eigen product te tonen, poll je
GET /bounty_submissions, gefilterd op de bounty. Eén keer per minuut past bij een wachtrij die een persoon beoordeelt. Schaal terug naar eens per paar minuten wanneer een bounty geen recente activiteit heeft.
Een bounty annuleren
POST /bounties/{id}/cancel betaalt de financier direct terug wanneer er geen werk loopt. Wanneer er werk in beoordeling is, stopt het nieuwe inzendingen en wordt de bounty geannuleerd zodra dat werk is afgehandeld en uitbetaald.
Het verzoek herhalen doet niets. Een bounty die al elke plek heeft uitbetaald, retourneert een 400.
Verzoeken die door de validatie komen en toch mislukken
Vier regels die het verzoekschema niet kan uitdrukken. Elk ervan retourneert een fout, ook al is de body correct opgebouwd:experience_idweggelaten zonder dataccount_idis ingesteld.frequencyverzonden zonderpublish_at.capture_specverzonden wanneerbusiness_goal_typeiets anders is dandata_capture.- Een
deliverablezonder link en zonder bestand.
Volgende stappen
Overzicht van bounties
De objecten en hoe ze samenhangen.
Bestanden uploaden
Haal de bestands-ID’s op waarnaar een deliverable verwijst.
Bounties-referentie
Verzoek- en responsstructuren voor elk endpoint.
Referentie voor bounty-inzendingen
Het inzendingsobject en de filters ervan.

