通知 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 有效	字串	N

• 請求

  字段名稱	描述	類型	必需
  appid	達成 CPA 的遊戲的 App ID	字串	是
  vid 或 uid	必須使用其中一個，vid 或 uid - vid: 使用身份驗證 v4 時的玩家 ID。使用身份驗證 v1 時的 VID - uid: 由平台管理的用戶 ID，例如 HIVE ID 和 Kakao App Center ID	字串	是
  server_id	用於區分遊戲用戶的伺服器的值	字串	是
  cpa_code	進行中的 CPA 代碼（需要與 UA 操作 PIC 檢查）	字串	是
  cpa_date	CPA 達成時間，韓國標準時間 (KST)（默認：API 實施時間）	字串	否

• Response

  字段名称	描述	类型
  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":"成功。"}