캠페인 완료

사용자가 정상적으로 광고를 완료한 경우, 리워드를 지급하기 위해 매체측에 캠페인 완료 콜백 API를 호출합니다. 해당 API를 요청받은 매체는 아래와 같은 요청을 처리해야 합니다.

• 사용자에게 리워드 지급

• 완료이력 기록

• 푸시 발송 (Optional)

API 호출 간 보안을 위해 검증 방식으로 HMAC을 사용하고 있습니다. HMAC 생성 및 검증을 참조하여 적용해 주시기 바랍니다.

적립금 지급 Callback

POST

사용자가 참여 완료하는 시점에 매체에서 정의된 Callback URL로 다음의 요청을 전달합니다.

Request Body

Name	Type	Description
click_key*	string	참여 완료 식별자 (최대 255자)
uid*	string	사용자 식별자 (최대 80자)
advertising_id*	string	참여 완료한 디바이스의 광고 식별자 (최대 37자)
platform*	integer	참여 완료한 디바이스의 플랫폼 (e.g. 1: 안드로이드, 2: iOS)
campaign_id*	integer	참여 완료한 캠페인의 ID
ad_name*	string	참여 완료한 광고의 이름 (최대 255자)
reward*	integer	사용자에게 지급할 리워드의 금액
reward_type*	integer	사용자에게 지급할 리워드의 타입

Response

200

// json 포맷 응답만 가능합니다.
// code 값은 문자열이 아닌 숫자형입니다.

{ "code": 200, "message": "success" }

400

// [필수 code, message 정의]
// 101, HMAC 인증 오류
// 102, 파라미터 오류
// 103, 올바르지 않은 uid
// 104, 중복 호출 (click_key 중복)
// 400, 기타 오류 

{ "code": {정의된 error_code}, "message": "{정의된 error_message}" }