Skip to main content
바운티가 게시되면 보상금이 에스크로에 보관되고, 작업자는 완료한 작업의 증빙을 제출하며, 승인된 각 제출물에 대해 모든 우승자 슬롯이 채워질 때까지 보상이 지급됩니다. Bounties API를 사용하여 바운티를 생성 및 게시하고, 보고나 대시보드를 위해 계정의 바운티를 조회하고, 사용자가 작업할 수 있거나 참여한 바운티를 조회하고, ID로 단일 바운티를 조회할 수 있습니다.

엔드포인트

속성

string
필수
바운티 ID이며, 접두사는 bnty_입니다.
string[]
필수
이 바운티가 허용하는 결과물 형태입니다. 모든 바운티는 content_url(게시된 링크)과 media(업로드된 파일)의 어떤 조합이든 허용하지만, data_capture 바운티는 예외입니다. 이 바운티의 증빙은 Whop 앱에서 녹화되어 시도에 누적되는 클립입니다.사용 가능한 옵션: content_url, media, data_capture
integer
필수
지금까지 승인된 제출물 수입니다.
integer
필수
승인될 수 있는 제출물 수(우승자 슬롯)입니다.
integer
필수
한 작업자가 차지할 수 있는 우승자 슬롯 수입니다. 기본값은 1입니다. 우승 수와 검토 대기 중인 증빙 수의 합은 이 숫자를 초과할 수 없으며, 작업자는 한 번에 하나의 시도만 진행합니다. accepted_submissions_limit을 초과할 수 없습니다.
object[]
필수
현재 이 바운티에서 진행 중인 증빙 라이브 스트림으로, 최신순으로 정렬됩니다. 작업자가 자신의 시도를 스트리밍하는 것입니다. 진행 중인 라이브가 없으면 비어 있습니다.

속성

string
필수
라이브 스트림 피드 ID입니다.
object | null
필수
증빙 라이브 스트림을 호스팅하는 사용자, 즉 자신의 시도를 스트리밍하는 작업자입니다. 호스트 계정이 더 이상 존재하지 않으면 null입니다.

속성

string
필수
사용자 ID이며, 접두사는 user_입니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
string
필수
공개 사용자 이름입니다.
string
필수
증빙 라이브 스트림의 표시 제목입니다.
number
필수
작업자가 추천인의 제휴 링크를 통해 유입된 경우, 추천인이 승인된 제출물당 받는 금액으로, 표준 플랫폼 수수료율 기준의 정수 통화 단위입니다. 보상에 추가되는 것이 아니라 작업자의 수수료 차감 후 보상에서 공제됩니다. 바운티가 제휴 수익을 지급하지 않는 경우 0이며, 추천을 기록할 수 없는 계정에 연결되지 않은 바운티도 포함됩니다.
string[]
필수
거주자가 바운티 작업을 할 수 있는 국가로, ISO 3166 alpha-2 코드로 표시됩니다. 비어 있으면 전 세계를 의미합니다.
integer
필수
제출되어 검토를 기다리는 제출물입니다. 아직 진행 중인 시도도 함께 집계하는 unresolved_submissions_count의 하위 집합입니다.
number
필수
바운티에 할당된 총 예산으로, gross_reward_amount 곱하기 accepted_submissions_limit입니다.
string | null
필수
게시자가 작업을 통해 달성하고자 하는 목표로, 생성 시 한 번 지정됩니다. 분류 체계가 도입되기 전에 생성된 바운티는 null입니다.사용 가능한 옵션: clipping, post_engagement, owned_account_growth, ugc_content, local_activation, data_capture, other
string | null
필수
취소가 요청된 시점으로, ISO 8601 타임스탬프입니다. closed 바운티에서는 취소가 보류 중임을 의미합니다. 즉, 제출이 중단되었으며 진행 중인 제출물이 처리되면 바운티가 취소됩니다. canceled 바운티에서는 취소가 요청된 시점을 기록합니다. 취소가 요청된 적이 없으면 null입니다.
object | null
필수
영상 녹화 시 준수해야 하는 기술 사양입니다. data_capture 바운티에만 존재하며, 다른 모든 목표 유형에서는 null입니다.

속성

string
필수
필수 메타데이터 필드로 구성되는 업로드 파일 명명 규칙입니다.
object
필수
관성 측정 장치(IMU) 녹화 요구 사항입니다.

속성

string
필수
기기 모션 채널의 단위로, 간결한 key=unit 문자열입니다.
string
필수
자력계 채널의 단위입니다.
number
필수
클립이 검증을 통과하기 위한 최소 지속 IMU 샘플링 속도(Hz)입니다.
integer
필수
목표 IMU 샘플링 속도(Hz)입니다.
number
필수
워밍업 구간 동안 허용되는 최소 IMU 샘플링 속도(Hz)입니다.
integer
필수
완화된 워밍업 속도가 적용되는 시작 구간(나노초)입니다.
integer
필수
클라이언트가 업로드하는 캡처 매니페스트에 기재해야 하는 스키마 버전입니다.
integer
필수
단일 클립의 최소 길이(초)입니다.
integer
필수
제출하기 전에 모든 클립에 걸쳐 누적해야 하는 총 검증된 영상 길이(초)입니다. 항상 정수 시간 단위입니다.
string[]
필수
제출물이 제공해야 하는 메타데이터 필드로, 제출물 API의 metadata 객체와 일치합니다.
boolean
필수
각 클립이 이어 붙인 세그먼트가 아닌 하나의 연속된 녹화여야 하는지 여부입니다.
object
필수
비디오 녹화 요구 사항입니다.

속성

integer
필수
허용되는 최대 평균 비트레이트(Mbps)입니다.
integer
필수
허용되는 최소 평균 비트레이트(Mbps)입니다.
integer
필수
인코딩 시 권장되는 평균 비트레이트(Mbps)입니다.
string
필수
녹화에 사용할 물리적 렌즈입니다.
string[]
필수
허용되는 비디오 코덱으로, 선호 순서대로 나열됩니다.
boolean
필수
클라이언트가 카메라 제조사와 모델을 비디오 컨테이너의 메타데이터에도 기록해야 하는지 여부입니다. false인 경우 캡처 매니페스트와 내보내기 CSV가 메타데이터를 담습니다.
integer
필수
목표 캡처 프레임 레이트입니다.
integer
필수
클라이언트가 클립을 거부하기 전까지 클립에 허용되는 연속 프레임 간 최대 정지 시간(밀리초)입니다. 모든 프레임은 프레임 로그에 타임스탬프가 기록되므로 정지가 있어도 이후 단계에서 정렬할 수 있습니다. 이 값은 캡처가 얼마나 균일하게 진행되어야 하는지가 아니라 얼마나 손상될 수 있는지의 한계를 정합니다.
integer
필수
필수 프레임 높이(픽셀)로, 녹화된 영상은 정확히 일치해야 합니다.
integer
필수
허용되는 최소 수평 시야각(도)입니다.
string
필수
녹화 시 기기 방향입니다.
integer
필수
선호하는 수평 시야각(도)입니다.
string
필수
클라이언트가 비디오 안정화를 구성하는 방법입니다. off는 포즈 추출을 위해 원본 모션이 보존되도록 EIS를 비활성화하고, on은 안정화를 필수로 하며, any는 기기 기본값을 유지합니다.사용 가능한 옵션: off, on, any
boolean
필수
하드웨어/소프트웨어 안정화를 활성화해야 하는지 여부입니다. stabilization_mode가 on일 때에만 정확히 true입니다.
integer
필수
필수 프레임 너비(픽셀)로, 녹화된 영상은 정확히 일치해야 합니다.
string
필수
바운티가 생성된 시점으로, ISO 8601 타임스탬프입니다.
string
필수
바운티의 모든 금액에 사용되는 통화로, 소문자 ISO 4217 코드입니다.사용 가능한 옵션: 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
필수
검토 후 거절된 제출물입니다.
string
필수
작업자에게 표시되는 전체 작업 지침입니다.
string | null
필수
바운티의 토론 스레드가 있는 익스피리언스로, 접두사는 exp_입니다. 스레드를 열려면 experience_id가 아닌 이 값을 사용하세요. 플랫폼 전체 바운티는 자체 호스팅 익스피리언스가 없지만 토론은 여전히 하나의 익스피리언스에 존재합니다.
string | null
필수
바운티의 토론 스레드를 포함하는 포럼 피드입니다. 포럼 게시물이 없는 바운티는 null입니다.
string | null
필수
바운티의 토론 스레드의 기준이 되는 포럼 게시물입니다. 스레드를 지정하려면 discussion_experience_id와 함께 사용하세요. 포럼 게시물이 없는 바운티는 null입니다.
string | null
필수
바운티가 호스팅되는 익스피리언스로, 접두사는 exp_입니다. 플랫폼 전체 바운티는 null이며, 자금 제공자와 다른 계정에 속할 수 있습니다.
object | null
필수
잔액으로 바운티 풀에 자금을 제공하는 계정이며, 사용자가 개인적으로 자금을 제공하는 경우 null입니다. experience_id를 호스팅하는 계정과 다를 수 있습니다.

속성

string
필수
계정 ID이며, 접두사는 biz_입니다.
string
필수
계정 표시 이름입니다.
number
필수
승인된 제출물 전체에 걸쳐 바운티 풀에서 지급된 총액으로, 작업자 지급액, 플랫폼 수수료, 제휴 수익을 모두 합한 금액입니다. 팁과 검토자 보상은 제외됩니다.
number
필수
승인된 제출물당 할당되는 바운티 풀 총액으로, 정수 통화 단위입니다.
object | null
필수
바운티의 포럼을 호스팅하는 계정입니다. 이 계정의 route와 experience_id가 토론 스레드를 지정하며, 제출물 대시보드도 이 계정에 있습니다. 호스트가 없는 플랫폼 전체 바운티는 null입니다. funding_account와 다를 수 있습니다.

속성

string
필수
계정 ID이며, 접두사는 biz_입니다.
string | null
필수
계정 로고 이미지 URL입니다. 계정에서 설정하지 않은 경우 null입니다.
string
필수
계정 공개 경로 식별자로, whop.com/\{route} 스토어프론트 경로에 사용됩니다.
string
필수
계정 표시 이름입니다.
integer | null
필수
제출하기 전에 누적해야 하는 총 검증된 영상 길이(초)입니다. 항상 정수 시간 단위입니다. data_capture 바운티에만 존재하며, net_reward_amount가 지급되는 기준이므로 단가 표시는 이 값으로 나눕니다. 다른 모든 목표 유형에서는 null입니다.
number
필수
플랫폼 수수료 차감 후 승인된 제출물당 작업자에게 제시되는 금액으로, 정수 통화 단위입니다. 표준 플랫폼 수수료율 기준의 정확한 수수료 차감 후 금액이며, 다른 수수료율이 고정된 작업자나 제휴 링크를 통해 유입된 작업자는 다른 금액을 지급받습니다.
object
필수
바운티를 게시한 사용자입니다. 계정 API 키로 생성된 경우 계정 소유자입니다.

속성

string
필수
사용자 ID이며, 접두사는 user_입니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
string
필수
공개 사용자 이름입니다.
string | null
필수
일정에 따라 새 바운티가 생성되는 빈도입니다. 각 회차는 별도의 바운티이며, 원본은 다시 게시되지 않습니다.사용 가능한 옵션: once, hourly, daily, weekly, monthly
string | null
필수
예약된 바운티가 게시될 시점으로, ISO 8601 타임스탬프입니다. 게시된 후, 예약된 적이 없는 바운티, 수동 재예약을 위해 보류된 최종 실패 초안의 경우 null입니다.
integer
필수
채워지지 않은 우승자 슬롯 수로, accepted_submissions_limit에서 accepted_submissions_count를 뺀 값이며 최솟값은 0입니다. 이 값만으로 바운티가 새 참여를 받는지 판단할 수는 없습니다. 이를 확인하려면 status를 확인하세요. open 바운티만 새 제출물을 받습니다.
string
필수
수명 주기 상태입니다. scheduled 바운티는 게시되지 않은 초안으로, 게시자와 계정의 권한 있는 관리자에게만 표시됩니다. open 바운티는 새 제출물을 받습니다. closed 바운티는 활성 상태이지만 더 이상 새 제출물을 받지 않습니다. completed 바운티는 모든 우승자 슬롯에 보상을 지급했습니다. canceled 바운티는 슬롯을 모두 채우기 전에 종료되었습니다.사용 가능한 옵션: scheduled, open, closed, completed, canceled
string | null
필수
새 제출물 접수가 중단된 시점으로, ISO 8601 타임스탬프입니다. 진행 중인 작업이 있는 바운티에 취소가 요청되면 설정되어, 바운티가 취소되기 전에 진행 중인 제출물이 처리될 수 있도록 합니다. 제출이 중단된 적이 없으면 null이며, 모든 우승자 슬롯을 채워 완료된 바운티도 포함됩니다.
string
필수
작업자에게 표시되는 작업의 짧은 이름입니다.
integer
필수
아직 결과를 기다리는 제출물로, 진행 중이거나 검토 대기 중인 제출물입니다.
string
필수
바운티가 마지막으로 업데이트된 시점으로, ISO 8601 타임스탬프입니다.
integer
필수
인증된 사용자가 이 바운티에서 이미 차지한 우승자 슬롯 수입니다. accepted_submissions_per_user_limit과 비교하여 작업자에게 남은 허용량을 보여주세요. 요청에 인증된 사용자가 없으면 0입니다.
Bounty