아이템 지급 결과 전송 API는 Hive IAP v4를 통해 소모성 상품을 구매한 유저에게 아이템을 지급한 결과를 전송하는 API입니다. 이 API를 구현하면, 마켓 환불·취소 목록에서 환불 어뷰징 유저 제재에 필수적인 아이템 지급 여부를 Hive IAP 시스템이 대신 전송합니다.
- Request URL
상용 URL https://hiveiap.qpyou.cn/api_v4/item_result Sandbox URL https://sandbox-hiveiap.qpyou.cn/api_v4/item_result HTTP Method POST Content-Type text/HTML;charset=utf-8 Data Format JSON
필드 | 타입 | 설명 | 필수 | |
---|---|---|---|---|
hiveiap_transaction_id | String | Hive IAP v4 영수증 검증에서 응답한 hiveiap_transaction_id 값을 전송 | Y | |
result_status | Integer | 아이템 지급 성공여부 0: 지급 실패 1: 지급 성공 |
Y | |
user_id_type | String | Hive 유저 타입 v0: 개별모듈(uid) v1: 인증v1(vid) v4: 인증v4(player_id) |
Y | |
user_id | String | 유저 ID user_id_type이 v0이면 uid, v1이면 vid, v4면 player_id를 전송 |
Y | |
asset | Array | 지급한 아이템 정보 지급 성공일 때만 값을 전달하고, 지급 실패일 때는 빈 array([])로 응답 |
N | |
asset_id | String | 아이템 ID | N | |
asset_name | String | 아이템 이름 | N | |
quantity | Integer | 지급한 아이템 개수 | N | |
game_payload_info | Object | Hive 애널리틱스에서 추가 지표로 활용하기 위해 게임 서버로부터 전달 받는 값 | N |
- 예제 코드
- 호출
12curl -L -v -d '{"hiveiap_transaction_id": "GO_22160", "result_status": 1, "user_id_type": "v4", "user_id": 30000041527, "asset": [ {"asset_id":"item_1","asset_name":"item_1_name","quantity":1},{"asset_id":"item_2","asset_name":"item_2_name","quantity":1}], "game_payload_info": {"gifteeid":null,"chracter_type_id":0,"product_name":"쿠킹덤 대체 상점팩 1"}}' -H "Content-Type: text/html" https://sandbox-hiveiap.qpyou.cn/api_v4/item_result - 요청
1234567> POST /api_v4/item_result HTTP/2> Host: sandbox-hiveiap.qpyou.cn> user-agent: curl/7.68.0> accept: /> content-type: text/html> content-length: 235 - 응답
123456< HTTP/2 200< server: nginx< date: Wed, 23 Mar 2022 08:20:44 GMT< content-type: text/html; charset=utf-8{"result":0,"result_msg":"success"}
- 호출