Skip to main content
Ödül, görev yayınlandığında emanette tutulur; çalışanlar tamamlanan işin kanıtını gönderir ve kabul edilen her gönderim, tüm kazanan kontenjanları dolana kadar ödenir. Ödül Görevleri API’sini bir ödül görevi oluşturup yayınlamak, raporlama veya panolar için bir hesabın ödül görevlerini listelemek, bir kullanıcının üzerinde çalışabileceği veya katıldığı ödül görevlerini listelemek ve tek bir ödül görevini kimliğine göre almak için kullanın.

Uç noktalar

Öznitelikler

string
gerekli
bnty_ önekli ödül görevi kimliği.
string[]
gerekli
Bu ödül görevinin kabul ettiği teslimat biçimleri. Her ödül görevi content_url (paylaşılan bağlantılar) ve media (yüklenen dosyalar) türlerinin herhangi bir kombinasyonunu kabul eder; bunun istisnası, kanıtı Whop uygulamasında kaydedilen ve deneme üzerinde biriken kliplerden oluşan data_capture ödül görevleridir.Kullanılabilir seçenekler: content_url, media, data_capture
integer
gerekli
Şimdiye kadar kabul edilen gönderimler.
integer
gerekli
Kabul edilebilecek gönderim sayısı (kazanan kontenjanları).
integer
gerekli
Bir çalışanın kaç kazanan kontenjanı kazanabileceği. Varsayılan değer 1’dir. Kazanımlar ile incelemeyi bekleyen kanıtların toplamı bu sayıyı asla aşmaz ve bir çalışan aynı anda yalnızca bir deneme yürütür. accepted_submissions_limit değerini aşamaz.
object[]
gerekli
Şu anda bu ödül görevinde yayında olan kanıt canlı yayınları, en yeniden eskiye — denemelerini yayınlayan çalışanlar. Yayında hiçbir şey yoksa boştur.

Özellikler

string
gerekli
Canlı yayın akışı kimliği.
object | null
gerekli
Kanıt canlı yayınına ev sahipliği yapan kullanıcı — denemesini yayınlayan çalışan. Ev sahibi hesap artık mevcut değilse null.

Özellikler

string
gerekli
user_ önekli kullanıcı kimliği.
string | null
gerekli
Görünen ad.
object
gerekli
Avatar sarmalayıcısı. url değeri her zaman mevcuttur ve kullanıcı bir resim ayarlamadığında oluşturulmuş bir yer tutucudur.

Özellikler

string
gerekli
Avatar resim URL’si. Her zaman mevcuttur. Kullanıcı bir resim ayarlamadığında oluşturulmuş bir yer tutucudur.
string
gerekli
Herkese açık kullanıcı adı.
string
gerekli
Kanıt canlı yayınının görünen başlığı.
number
gerekli
Çalışan, bir yönlendiricinin satış ortaklığı bağlantısı aracılığıyla geldiğinde, yönlendiricinin kabul edilen gönderim başına kazandığı tutar; tam para birimi cinsinden ve standart platform ücreti oranında. Üste eklenmez, çalışanın ücret sonrası ödülünden düşülür. Ödül görevi satış ortaklığı payı ödemiyorsa 0; buna, yönlendirme kaydedemeyen ve hiçbir hesaba bağlı olmayan ödül görevleri de dahildir.
string[]
gerekli
Sakinleri ödül görevinde çalışabilecek ülkeler, ISO 3166 alpha-2 kodları olarak. Boş olması dünya genelinde anlamına gelir.
integer
gerekli
Teslim edilmiş ve incelemeyi bekleyen gönderimler. Hâlâ devam eden denemeleri de sayan unresolved_submissions_count değerinin bir alt kümesidir.
number
gerekli
Ödül görevine ayrılan toplam brüt bütçe: gross_reward_amount çarpı accepted_submissions_limit.
string | null
gerekli
Görevi yayınlayanın işle neyi başarmak istediği; oluşturma sırasında bir kez belirtilir. Sınıflandırma kullanıma sunulmadan önce oluşturulan ödül görevleri için null.Kullanılabilir seçenekler: clipping, post_engagement, owned_account_growth, ugc_content, local_activation, data_capture, other
string | null
gerekli
İptalin talep edildiği zaman, ISO 8601 zaman damgası olarak. closed durumundaki bir ödül görevinde bu, iptalin beklemede olduğu anlamına gelir: gönderimler durdurulmuştur ve devam eden gönderimler sonuçlandığında ödül görevi iptal edilir. canceled durumundaki bir ödül görevinde iptalin ne zaman talep edildiğini kaydeder. Hiç iptal talep edilmediyse null.
object | null
gerekli
Görüntülerin kaydedilmesi gereken teknik sözleşme. Yalnızca data_capture ödül görevlerinde bulunur; diğer tüm hedef türleri için null.

Özellikler

string
gerekli
Gerekli meta veri alanlarından oluşturulan, yüklenen dosyalar için adlandırma kuralı.
object
gerekli
Ataletsel ölçüm birimi (IMU) kayıt gereksinimleri.

Özellikler

string
gerekli
Cihaz hareketi kanallarının birimleri, kompakt bir anahtar=birim dizesi olarak.
string
gerekli
Manyetometre kanalının birimleri.
number
gerekli
Bir klibin doğrulamayı geçmesi için gereken minimum sürekli IMU örnekleme hızı (hertz).
integer
gerekli
Hedef IMU örnekleme hızı (hertz).
number
gerekli
Isınma penceresi sırasında tolere edilen minimum IMU örnekleme hızı (hertz).
integer
gerekli
Gevşetilmiş ısınma hızının uygulandığı başlangıç penceresi (nanosaniye).
integer
gerekli
İstemcinin yüklediği yakalama manifestosuna işlemesi gereken şema sürümü.
integer
gerekli
Tek bir klibin minimum uzunluğu (saniye).
integer
gerekli
Bir gönderimin gönderilebilmesi için tüm klipleri genelinde biriktirmesi gereken toplam doğrulanmış görüntü süresi (saniye). Her zaman tam saat sayısıdır.
string[]
gerekli
Bir gönderimin sağlaması gereken, gönderimler API’sindeki metadata nesnesiyle eşleşen meta veri alanları.
boolean
gerekli
Her klibin birleştirilmiş parçalar yerine kesintisiz tek bir kayıt olması gerekip gerekmediği.
object
gerekli
Video kayıt gereksinimleri.

Özellikler

integer
gerekli
Kabul edilebilir maksimum ortalama bit hızı (megabit/saniye).
integer
gerekli
Kabul edilebilir minimum ortalama bit hızı (megabit/saniye).
integer
gerekli
Kodlama için önerilen ortalama bit hızı (megabit/saniye).
string
gerekli
Kayıt için hangi fiziksel lensin kullanılacağı.
string[]
gerekli
Kabul edilen video codec’leri, tercih sırasına göre.
boolean
gerekli
İstemcinin kamera markasını ve modelini video kapsayıcısının meta verilerine de yazması gerekip gerekmediği. false olduğunda meta verileri yakalama manifestosu ve dışa aktarma CSV’si taşır.
integer
gerekli
Hedef yakalama kare hızı.
integer
gerekli
İstemci klibi reddetmeden önce bir klibin ardışık kareler arasında içerebileceği en uzun duraklama (milisaniye). Her kare kare günlüğünde zaman damgalıdır, bu nedenle bir duraklama sonraki aşamalarda hizalanabilir kalır — bu değer, bir kaydın ne kadar eşit aralıklı olması gerektiğini değil, ne kadar bozuk olabileceğini sınırlar.
integer
gerekli
Piksel cinsinden gerekli kare yüksekliği — kaydedilen görüntü tam olarak eşleşmelidir.
integer
gerekli
Kabul edilebilir minimum yatay görüş alanı (derece).
string
gerekli
Kayıt için cihaz yönü.
integer
gerekli
Tercih edilen yatay görüş alanı (derece).
string
gerekli
İstemcinin video sabitlemeyi nasıl yapılandırması gerektiği: off, ham hareketin poz çıkarımı için korunması amacıyla EIS’yi devre dışı bırakır, on bunu zorunlu kılar, any cihaz varsayılanını bırakır.Kullanılabilir seçenekler: off, on, any
boolean
gerekli
Donanım/yazılım sabitlemenin etkin olması gerekip gerekmediği. Tam olarak stabilization_mode on olduğunda true’dur.
integer
gerekli
Piksel cinsinden gerekli kare genişliği — kaydedilen görüntü tam olarak eşleşmelidir.
string
gerekli
Ödül görevinin oluşturulduğu zaman, ISO 8601 zaman damgası olarak.
string
gerekli
Ödül görevindeki tüm tutarların para birimi, küçük harfli ISO 4217 kodu olarak.Kullanılabilir seçenekler: 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
gerekli
İncelenip reddedilen gönderimler.
string
gerekli
Çalışanlara gösterilen tam görev talimatları.
string | null
gerekli
Ödül görevinin tartışma dizisinin bulunduğu exp_ önekli deneyim. Diziyi açmak için experience_id değil bunu okuyun: platform genelindeki bir ödül görevinin kendine ait bir barındırma deneyimi yoktur, ancak tartışması yine de bir deneyimde bulunur.
string | null
gerekli
Ödül görevinin tartışma dizisini içeren forum akışı. Forum gönderisi olmayan bir ödül görevi için null.
string | null
gerekli
Ödül görevinin tartışma dizisini sabitleyen forum gönderisi. Diziyi adreslemek için discussion_experience_id ile birlikte okuyun. Forum gönderisi olmayan bir ödül görevi için null.
string | null
gerekli
Ödül görevinin barındırıldığı exp_ önekli deneyim. Platform genelindeki ödül görevleri için null; fon sağlayıcıdan farklı bir hesaba ait olabilir.
object | null
gerekli
Bakiyesi ödül havuzunu finanse eden hesap veya bir kullanıcı kişisel olarak finanse ettiğinde null. experience_id değerini barındıran hesaptan farklı olabilir.

Özellikler

string
gerekli
biz_ önekli hesap kimliği.
string
gerekli
Hesabın görünen adı.
number
gerekli
Kabul edilen gönderimler genelinde ödül havuzundan ödenen brüt tutar — çalışan ödemeleri, platform ücretleri ve satış ortaklığı payları birlikte. Bahşişler ve inceleyici ödülleri hariçtir.
number
gerekli
Kabul edilen gönderim başına ayrılan brüt ödül havuzu tutarı, tam para birimi cinsinden.
object | null
gerekli
Ödül görevinin forumunu barındıran hesap — route ve experience_id değerleri tartışma dizisini adresleyen ve gönderim panosunun bulunduğu hesap. Ev sahibi olmayan platform genelindeki bir ödül görevi için null. funding_account değerinden farklı olabilir.

Özellikler

string
gerekli
biz_ önekli hesap kimliği.
string | null
gerekli
Hesap logosu resim URL’si. Hesap bir logo ayarlamadıysa null.
string
gerekli
whop.com/\{route} mağaza yolunda kullanılan, hesabın herkese açık rota tanımlayıcısı.
string
gerekli
Hesabın görünen adı.
integer | null
gerekli
Bir gönderimin gönderilebilmesi için biriktirmesi gereken toplam doğrulanmış görüntü süresi (saniye). Her zaman tam saat sayısıdır. Yalnızca data_capture ödül görevlerinde bulunur — net_reward_amount bunun karşılığında ödenir, dolayısıyla oran gösterimleri bu değere bölünür. Diğer tüm hedef türleri için null.
number
gerekli
Bir çalışana kabul edilen gönderim başına platform ücreti sonrasında teklif edilen tutar, tam para birimi cinsinden. Standart platform ücreti oranında tam ücret sonrası rakamdır — farklı bir oranı sabitlemiş veya bir satış ortaklığı bağlantısı aracılığıyla gelmiş bir çalışana farklı bir tutar ödenir.
object
gerekli
Ödül görevini yayınlayan kullanıcı — bir hesap API anahtarıyla oluşturulduğunda hesap sahibi.

Özellikler

string
gerekli
user_ önekli kullanıcı kimliği.
string | null
gerekli
Görünen ad.
object
gerekli
Avatar sarmalayıcısı. url değeri her zaman mevcuttur ve kullanıcı bir resim ayarlamadığında oluşturulmuş bir yer tutucudur.

Özellikler

string
gerekli
Avatar resim URL’si. Her zaman mevcuttur. Kullanıcı bir resim ayarlamadığında oluşturulmuş bir yer tutucudur.
string
gerekli
Herkese açık kullanıcı adı.
string | null
gerekli
Zamanlamanın ne sıklıkla yeni bir ödül görevi oluşturduğu. Her tekrar ayrı bir ödül görevidir; orijinal yeniden yayınlanmaz.Kullanılabilir seçenekler: once, hourly, daily, weekly, monthly
string | null
gerekli
Zamanlanmış bir ödül görevinin yayınlanacağı zaman, ISO 8601 zaman damgası olarak. Yayınlandıktan sonra, hiç zamanlanmamış ödül görevleri için ve manuel yeniden zamanlama için bekletilen kalıcı olarak başarısız taslaklar için null.
integer
gerekli
Doldurulmamış kazanan kapasitesi: accepted_submissions_limit eksi accepted_submissions_count, sıfırla sınırlandırılmış. Tek başına ödül görevinin yeni talepleri kabul ettiğinin bir işareti değildir — bunun için status değerini okuyun: yalnızca open durumundaki bir ödül görevi yeni gönderim alır.
string
gerekli
Yaşam döngüsü durumu. scheduled ödül görevleri, yalnızca yayınlayana ve hesabın yetkili yöneticilerine görünen yayınlanmamış taslaklardır; open ödül görevleri yeni gönderimleri kabul eder; closed ödül görevleri yayındadır ancak artık yeni gönderim kabul etmez; completed ödül görevleri tüm kazanan kontenjanlarını ödemiştir; canceled ödül görevleri kontenjanlarını doldurmadan sona ermiştir.Kullanılabilir seçenekler: scheduled, open, closed, completed, canceled
string | null
gerekli
Yeni gönderimlerin kabul edilmesinin durduğu zaman, ISO 8601 zaman damgası olarak. Devam eden işi olan bir ödül görevinde iptal talep edildiğinde ayarlanır, böylece devam eden gönderimler ödül görevi iptal edilmeden önce sonuçlanabilir. Gönderimler hiç durdurulmadıysa null — buna yalnızca tüm kazanan kontenjanlarını doldurmuş tamamlanmış ödül görevleri de dahildir.
string
gerekli
Çalışanlara gösterilen görevin kısa adı.
integer
gerekli
Hâlâ bir sonuç bekleyen gönderimler: devam eden veya incelemeyi bekleyen.
string
gerekli
Ödül görevinin son güncellendiği zaman, ISO 8601 zaman damgası olarak.
integer
gerekli
Kimliği doğrulanmış kullanıcının bu ödül görevinde zaten kazandığı kazanan kontenjanı sayısı. Bir çalışana kalan hakkını göstermek için accepted_submissions_per_user_limit ile karşılaştırarak okuyun. İstekte kimliği doğrulanmış kullanıcı yoksa 0.
Bounty