跳轉至

UA 活动状态

提供邀請狀態和邀請者(創建好友邀請鏈接的用戶)的活動成就狀態。

Request URL

實時網址 https://promotion.qpyou.cn/ua/process
沙盒網址 https://sandbox-promotion.qpyou.cn/ua/process
HTTP 方法 POST
內容類型 application/json

Header parameters

欄位名稱 描述 類型 必填
授權 進行 API 請求所需的身份驗證令牌(Bearer Authorization)。前往 Hive 控制台 AppCenter > Game Management > 遊戲列表:選擇您的公司 遊戲 > 遊戲 詳細資訊 > 基本資訊並使用認證金鑰作為令牌。 字串

Request body

字段名称 描述 类型 必需
gameindex 前往 Hive 控制台 AppCenter > 游戏 管理 > 游戏列表:选择您的公司’s 游戏 > 游戏 详细信息 > 基本 信息 > 游戏 索引 整数
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`時給予獎勵) 整數

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