UA 캠페인 진행 정보

초대한 유저(친구 초대 링크를 생성한 유저)의 초대 현황 및 캠페인 달성 정보를 제공합니다.

Request URL¶

Live URL	https://promotion.qpyou.cn/ua/process
Sandbox URL	https://sandbox-promotion.qpyou.cn/ua/process
HTTP Method	POST
Content-Type	application/json

Header parameters¶

필드명	설명	타입	필수 여부
Authorization	API를 호출하기 위한 인증 토큰(Bearer Authorization)입니다. Hive 콘솔 앱센터 > 게임관리 > 게임목록 > 앱 선택 후 기본정보 > Hive 인증키를 사용합니다.	string	N

Request body¶

필드명	설명	타입	필수 여부
gameindex	Hive 콘솔 앱센터 > 게임관리 > 게임목록 > 앱 선택 후 기본정보 > Game Index	Integer	Y
vid	초대자 VID입니다. 기본적으로 PlayerID와 동일합니다.	Integer	Y

Responses¶

필드명	설명	타입	필수 여부
result_code	응답 코드 200: 검증 성공 그 외 : 실패	Integer	Y
result_message	응답 메시지	String	Y
eachCampaignList	유저가 캠페인을 완료할 때마다 보상을 주는 캠페인 목록	Array	N
ㄴ campaign_id	캠페인 id	String	N
ㄴ order	캠페인 순서	Int	N
ㄴ count	캠페인 달성 수	Int	N
ㄴ limit	캠페인 달성 수 최대값	Int	N
stageCampaignList	캠페인 목표를 모두 달성한 친구 수가 목표 수에 도달할 때 보상을 지급하는 캠페인 목록	Array	N
ㄴ campaign_id	캠페인 id	String	N
ㄴ order	캠페인 순서	Int	N
ㄴ count	보상을 받은 회수	Int	N
ㄴ limit	최대 보상 회수(`count`의 최대값)	Int	N
ㄴ goalCount	모든 캠페인 목표를 달성한 유저 수	Int	N
ㄴ goalTotal	보상을 받기 위한 `goalCount`(`goalCount`가 `goalTotal`이 되면 보상을 지급)	Int	N

Request sample¶

curl -L -v
  -d '{"vid": 40088555, "gameindex": 539}' 
  -H "Content-Type: application/json" 
  https://sandbox-promotion.qpyou.cn/ua/process

Response sample¶

{
    "result_code": 200,
    "result_message": "success",
    "eachCampaignList": [
        {
            "campaign_id": "73",
            "order": 1,
            "count": 1,
            "limit": 10
        }, {
            "campaign_id": "163",
            "order": 2,
            "count": 0,
            "limit": 100
        }
    ],
    "stageCampaignList": [
        {
            "campaign_id": "202",
            "order": 3,
            "count": 1,
            "limit": 10,
            "goalCount": 0,
            "goalTotal": 5
        }
    ]
}