跳转至

UA 活动状态

提供邀请状态和邀请者(创建好友邀请链接的用户)的活动成就状态。

请求 URL

实时 URL https://promotion.qpyou.cn/ua/process
沙盒 URL https://sandbox-promotion.qpyou.cn/ua/process
HTTP 方法 POST
内容类型 application/json

Header parameters

字段名称 描述 类型 必需
Authorization 进行 API 请求所需的身份验证令牌(Bearer Authorization)。前往 Hive 控制台 AppCenter > Game Management > 游戏列表:选择您的公司 游戏 > 游戏 详情 > 基本信息,并使用认证密钥作为令牌。 字符串

Request body

字段名称 描述 类型 必需
gameindex 前往 Hive 控制台 AppCenter > 游戏 管理 > 游戏列表:选择您的公司 游戏 > 游戏 详情 > 基本 信息 > 游戏 索引 整数
vid 这是邀请者的 VID。默认情况下与 PlayerID 相同。 整数

响应

字段名称 描述 类型 必需
result_code
    响应代码
  • 200: 验证成功
  • 其他: 失败
整数
result_message 响应消息 字符串
eachCampaignList 每次用户完成活动时奖励用户的活动列表。 数组
ㄴ campaign_id 活动ID 字符串
ㄴ order 活动的顺序 整数
ㄴ count 完成的活动数量 整数
ㄴ limit 活动完成的最大数量 整数
stageCampaignList 当完成所有活动目标的受邀者数量达到目标数量时,奖励邀请者的活动列表。 数组
ㄴ campaign_id 活动ID 字符串
ㄴ order 活动的顺序 整数
ㄴ count 邀请者收到的奖励数量。 整数
ㄴ limit 奖励的最大数量(`count`的最大值) 整数
ㄴ goalCount 完成活动所有目标的受邀者数量。 整数
ㄴ goalTotal 获得奖励所需的`goalCount`(当`goalCount`达到`goalTotal`时给予奖励) 整数

请求 示例

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
        }
    ]
    }