通知 CPA 达成情况

在游戏中,当用户在推广控制台(Hive 控制台 > 推广)中达成注册的 CPA 时,您可以将信息发送到 Hive 服务器以向用户支付奖励。请从游戏服务器调用推广服务器以获取 CPA 成就通知。

  • 请求 URL
    常用 URL https://promotion.qpyou.cn/api/cpa
    沙盒 URL https://sandbox-promotion.qpyou.cn/api/cpa
    HTTP 方法 POST
    内容类型 text/html
    数据格式 JSON
  • 标题
    字段名称 描述 类型 是否必填
    授权 通过Bearer授权的CertificationKey有效 字符串
  • 标题
    字段名称 描述 类型 必需
    授权 通过Bearer授权的CertificationKey有效 字符串
  • 请求
    字段名称 描述 类型 是否必填
    appid 实现CPA的游戏的App ID 字符串
    vid 使用身份验证v4时的玩家ID 字符串
    server_id 区分游戏用户服务器的值 字符串
    cpa_code 进行中的CPA代码(需要与UA运营PIC确认) 字符串
    cpa_date CPA达成时间,韩国标准时间(KST)(默认:API实施时间) 字符串
  • 响应
    字段名称 描述 类型
    result_code 请求的结果。0=成功 整数
    result_msg 结果消息 字符串
  • 示例代码

    • 调用
    curl -L -v
    -d '{"appid":"com.com2us.hivesdk.normal.freefull.google.global.android.common", "vid":"300000011", "server_id":"kr", "cpa_code":"113", "cpa_date":"2022-03-15 12:00:00"}'
    -H "Content-Type: application/json"
    https://sandbox-promotion.qpyou.cn/api/cpa
    
    • 请求
    > POST /api/cpa HTTP/1.1
    > User-Agent: curl/7.29.0
    > Host: sandbox-promotion.qpyou.cn
    > Accept: /
    > Content-Type: application/json
    > Content-Length: 164
    
    • 回复
    < HTTP/1.1 200 OK
    < Server: nginx
    < Date: Tue, 15 Mar 2022 03:17:10 GMT
    < Content-Type: text/html; charset=UTF-8
    {"result_code":0,"result_message":"成功."}