CPA達成の通知

ゲーム内で、ユーザーがプロモーションコンソール（Hive コンソール > プロモーション）に登録されたCPAを達成すると、ユーザーに報酬を支払うためにHiveサーバーに情報を送信できます。ゲームサーバーからプロモーションサーバーにCPA達成通知を呼び出してください。

• リクエスト URL

  共通URL	https://promotion.qpyou.cn/api/cpa
  サンドボックスURL	https://sandbox-promotion.qpyou.cn/api/cpa
  HTTPメソッド	POST
  Content-Type	text/html
  データ形式	JSON

• ヘッダー

  フィールド名	説明	タイプ	必須
  認証	Bearer Authorizationを通じて有効なCertificationKey	文字列	N

• ヘッダー

  フィールド名	説明	タイプ	必須
  認証	Bearer認証を通じて有効なCertificationKey	文字列	N

• リクエスト

  フィールド名	説明	タイプ	必須
  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":"Success."}