CPA 달성 알림

게임에서는 HIVE 프로모션 콘솔에 등록된 CPA 달성 시, 해당 정보를 HIVE에 보내 보상을 지급할 수 있습니다. CPA 달성 알림은 게임 서버에서 프로모션 서버로 호출해 주세요.

• Request URL

상용 URL	https://promotion.qpyou.cn/v2/cpa/achievement
Sandbox URL	https://sandbox-promotion.qpyou.cn/v2/cpa/achievement
HTTP Method	POST
Content-Type	application/json
Data Format	JSON

• Header

필드명	설명	타입	필수 여부
X-Access-Token	앱 서버 인증을 위한 OAuth 2.0 Access Token (OAuth Token 발급하기 참고)	String	N

• Request

필드명	설명	타입	필수 여부
appid	CPA를 달성한 게임의 AppID	String	Y
vid	Hive 인증 v4에서 관리하는 PlayerID	String	Y
server_id	게임 내 유저 서버 구분 값	String	Y
cpa_code	진행하는 CPA코드 (UA 운영 담당자와 확인 필요)	String	Y
cpa_date	CPA 달성 시간, 한국 기준 시간(KST) (Default:API 호출 시간)	String	N

• Response

필드명	설명	타입
result_code	요청 결과, 0=성공	Integer
result_msg	결과 메시지	String

• 예제 코드

  • 호출

 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"
 -H "X-Access-Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6ImEwYWZlYjZlLTllYWItY2ZiMC03ZTMxLTNhNzMyZTQ5In0.eyJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5oaXZlc2RrIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImdyYW50X3R5cGUiOiJ1c2VyIiwiaWF0IjoxNzg5NDA2NzI5LCJleHAiOjE3ODk0MTAzMjksImF1dGhfdmVyIjoidjQiLCJ1c2VyX2lkIjoyMDAwMDAzMTM0MSwiaXNfd2hpdGVsaXN0IjpmYWxzZX0.MgPO-e-Gm_dErRcfjVPKFdrh9M1ywqpU5aBmrFDZihzA5kKCw_QjPZv-Sb94LmbrzIqYuGQu29tIbX9DhJg_SpschZ4dihLx75pt5fSqYkzXMNHsbDjP-A7Yn0yjqP8f9w0DD0B_20Vbw6WfUUImNLQK0UpKu9Pd6cOILImDOn9YSkc1ozuzGQ04jgihwSxtP8cRTNGn53aB89CbSzYZbUqdUtyCOY9q1BXeIlrq_4zd_YWoPPQjPd3uD3wt3cVNg4nfNfQ55PDXPTn-QCm_HsfnL12wrNFnD-UW9SlCvM6TouoErNFrLaQ3sYvgsek-n47-bylvzTGa7GAvakwuog"
 https://sandbox-promotion.qpyou.cn/v2/cpa/achievement

* 요청

 curl
 > POST /v2/cpa/achievement HTTP/1.1
 > User-Agent: curl/7.29.0
 > Host: sandbox-promotion.qpyou.cn
 > Accept: /
 > Content-Type: application/json
 > X-Access-Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6ImEwYWZlYjZlLTllYWItY2ZiMC03ZTMxLTNhNzMyZTQ5In0.eyJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5oaXZlc2RrIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImdyYW50X3R5cGUiOiJ1c2VyIiwiaWF0IjoxNzg5NDA2NzI5LCJleHAiOjE3ODk0MTAzMjksImF1dGhfdmVyIjoidjQiLCJ1c2VyX2lkIjoyMDAwMDAzMTM0MSwiaXNfd2hpdGVsaXN0IjpmYWxzZX0.MgPO-e-Gm_dErRcfjVPKFdrh9M1ywqpU5aBmrFDZihzA5kKCw_QjPZv-Sb94LmbrzIqYuGQu29tIbX9DhJg_SpschZ4dihLx75pt5fSqYkzXMNHsbDjP-A7Yn0yjqP8f9w0DD0B_20Vbw6WfUUImNLQK0UpKu9Pd6cOILImDOn9YSkc1ozuzGQ04jgihwSxtP8cRTNGn53aB89CbSzYZbUqdUtyCOY9q1BXeIlrq_4zd_YWoPPQjPd3uD3wt3cVNg4nfNfQ55PDXPTn-QCm_HsfnL12wrNFnD-UW9SlCvM6TouoErNFrLaQ3sYvgsek-n47-bylvzTGa7GAvakwuog
 > Content-Length: 164

* 응답

< HTTP/1.1 200 OK
                    < Server: nginx
                    < Date: Tue, 15 Mar 2022 03:17:10 GMT
                    < Content-Type: application/json; charset=UTF-8
                    {"result_code":0,"result_message":"Success."}

                    ```

---