1. 개요

본 문서는 귀사가 퀴즈/검색/저장 미션 완료 시, 당사 서버로 포스트백(Postback)을 전송하기 위한 연동 가이드입니다.

사용자가 귀사의 미션에 참여 완료하면, 귀사 서버에서 당사 포스트백 API를 호출하여 미션 완료를 알려주시면 됩니다.

2. 연동 흐름

[사용자] → [애드팝콘 오퍼월에서 참여시도(귀사 미션 페이지로 랜딩)] → [귀사 미션 페이지 참여] → [귀사 서버에서 미션 완료 판단] → [당사 포스트백 API 호출] → [당사 리워드 지급]
  1. 당사가 귀사의 미션 리스트 URL을 호출할 때, tid (Transaction ID)와 uid (유저 식별값)를 전달합니다.
  2. 사용자가 미션을 완료하면, 귀사 서버에서 당사 포스트백 API를 호출합니다.
  3. 당사는 포스트백을 수신하여 사용자에게 리워드를 지급합니다.

3. 미션 리스트 URL 호출 (당사 → 귀사)

당사가 귀사의 미션 리스트 페이지를 호출할 때 아래 파라미터를 URL에 포함하여 전달합니다.

Parameter Type Required Description
tid String Yes 당사에서 발급한 트랜잭션 ID (암호화된 값). 포스트백 호출 시 그대로 리턴해주셔야 합니다.
uid String Yes 당사 유저 식별값. 귀사 미션 페이지에서 유저를 식별하기 위한 용도입니다.

예시 URL:

<https://귀사도메인/mission/list?tid={TID}&uid={UID}>

[중요] tid 값은 포스트백 호출 시 반드시 원본 그대로 리턴해주셔야 합니다. uid는 귀사 미션 페이지에서 유저 식별 용도로만 사용하시면 됩니다.

4. 포스트백 API 명세 (귀사 → 당사)

사용자가 미션을 완료하면, 귀사 서버에서 아래 API를 호출해주시면 됩니다.

4.1 기본 정보