Provides the invitation status and the campaign achievement status for the inviter (the user who created the friend invitation link).
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
Field Name | Description | Type | Required |
---|---|---|---|
Authorization | The authentication token (Bearer Authorization) needed to make an API request. Go to the Hive Console AppCenter > Game Management > Game List: Select your company’s game > Game Details > Basic Info and use Hive Certification Key as the token. | string | N |
Request Body
Field Name | Description | Type | Required |
---|---|---|---|
gameindex | Go to the Hive Console AppCenter > Game Management > Game List: Select your company’s game > Game Details > Basic Info > Game Index | Integer | Y |
vid | This is the VID of the inviter. It is the same as the PlayerID by default. | Integer | Y |
Responses
Field Name | Description | Type | Required |
---|---|---|---|
result_code |
|
Integer | Y |
result_message | response message | String | Y |
eachCampaignList | the list of campaigns that reward a user each time they complete a campaign. | Array | N |
ㄴ campaign_id | the campaign id | String | N |
ㄴ order | the order of the campaigns | Int | N |
ㄴ count | the number of completed campaigns | Int | N |
ㄴ limit | the maximum number of completion of the campaigns | Int | N |
stageCampaignList | the list of campaigns that reward the inviter when the number of the invitees that completed all the campaign objectives reaches the target number. | Array | N |
ㄴ campaign_id | the campaign id | String | N |
ㄴ order | the order of the campaigns | Int | N |
ㄴ count | the number of the rewards that the inviter received. | Int | N |
ㄴ limit | the maximum number of rewards (the maximum value for count ) |
Int | N |
ㄴ goalCount | the number of the invitees that completed all objectives of a campaign. | Int | N |
ㄴ goalTotal | the goalCount required to receive reward (the reward is given when goalCount reaches goalTotal ) |
Int | N |
Request Sample
1 2 3 4 |
curl -L -v -d '{"vid": 40088555, "gameindex": 539}' \ -H "Content-Type: application/json" \ https://sandbox-promotion.qpyou.cn/ua/process |
Response Sample
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
{ "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 } ] } |