API Guide

클립에 대한 리워드 생성

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

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

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

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

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

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

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

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

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

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

Language
Click Try It! to start a request and see the response here!