GuidesAPI GuideChangelog
Log In
API Guide

클립에 대한 리워드 생성

클립에 리워드를 생성하기 위한 API 입니다.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

해당 API 를 호출할 경우 생성/수정으로 동작합니다.

  • 클립에 최초 호출 시 리워드 생성으로 동작합니다.
  • 같은 클립에 리워드가 이미 존재할 경우 수정으로 동작합니다.

리워드를 생성하기 위한 조건은 다음과 같습니다.

  1. 클립의 상태가 '비공개' 여야 합니다.
  2. 클립에 리워드가 등록된 후에 공개 상태로 전환된 이력이 없어야 합니다.

postbackEndpointUrl 등록 시 다음과 같이 요청하게 됩니다.

await axios.post(
	postbackEndpointUrl, // 포스트백 엔드포인트
	{ // Body 데이터
		identifier: "사용자 고유 식별자 값",
		type: "리워드 타입",
		metaData: { 
			"메타 데이터": "자유 양식, json 포맷"
		}
	}
);

clickValidationUrl 등록 시 다음과 같이 요청합니다.

await axios.post(
	clickValidationUrl, // 클릭 검증 엔드포인트
	{ // Body 데이터
		identifier: "사용자 고유 식별자 값",
		IDFA: "IDFA 값",
		ADID: "ADID 값"
	}
);

리워드 생성 후 해당 리워드에 사용자를 등록 하거나 달성 관련 API 는 리워드 사용자 등록과 리워드 달성을 확인해주세요.

Body Params
clipIds
array of int32s
required

리워드를 부여할 clipId 목록

clipIds*
string
enum
required

리워드 유형 (time, click, mixed)

Allowed:
boolean
required
Defaults to false

리워드 소진 시 클립 노출 여부

int32

리워드 지급 총액

int32

리워드 달성 시간, 초

int32
required

리워드 지급량

string
required

리워드 지급 단위

string

리워드 달성 시 포스트백 해줄 URL

string

클릭 검증이 필요한 경우의 URL

Headers
string
required

인증용 토큰

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의