이용 정지 등록 및 해제 이용 정지 등록 개발사 운영 정책에 따라 Hive 서버에서 계정을 이용 정지 상태로 만드는 기능을 제공합니다. Hive 콘솔에서 이용 정지 유형을 사전에 등록하면, 영구 이용 정지 사용자와 기간 제한이 있는 이용 정지 사용자를 구분해 등록할 수 있습니다. 또 기존에 등록한 사용자(PlayerID로 구분) 이용 정지 유형과 이용 정지 기간을 변경할 수 있습니다.
Basics Request URL 상용: https://auth.qpyou.cn/game/block/set 샌드박스: https://sandbox-auth.qpyou.cn/game/block/set Method POST HTTP Header Content-type: application/json ISCRYPT: 0 Response Format JSON
Request Parameter Type Required Description appid String O 앱 아이디 player_id Integer O 플레이어 아이디 hive_certification_key String O Hive 인증키(앱센터에서 발급) status String O 이용 정지 상태 P: 영구 이용 정지B: 이용 정지 기간이 있는 유저 block_type Integer O 이용 정지 유형 (Hive 콘솔에 반드시 등록해야 함: Hive 콘솔 > 인증 > 이용 정지 > 유형 등록 ) start_date String O 이용 정지 시작일 end_date String O 이용 정지 종료일
Response Parameter Type Description result_code Integer 결과 코드 0: 정상 4000: 유효하지 않은 파라미터 이용 정지 시작일과 종료일의 형식이 올바르지 않은 경우 시작일이 종료일보다 큰 경우 현재 시간이 종료일보다 큰 경우 4002: Hive 인증키 불일치 4011: 미등록 유형 6000: 유효하지 않은 appid result_msg String 이용 제한 사유 결과 메시지
Request examples
curl -X POST https://auth.qpyou.cn/game/block/set
-H 'Content-Type: application/json'
-H 'ISCRYPT: 0'
-d '{"appid" : "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal", "player_id" : 24000000000, "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY", "status" : "B", "block_type" : 18, "start_date" : "2024-06-03 00:00:00", "end_date" : "2024-06-30 23:59:59"}'
Response example
{
"result_code": 0,
"result_msg": "SUCCESS"
}
이용 정지 해제 특정 계정이 이용 정지된 상태를 Hive 서버에서 직접 해제합니다.
Basics Request URL 상용: https://auth.qpyou.cn/game/block/delete 샌드박스: https://sandbox-auth.qpyou.cn/game/block/delete Method POST HTTP Header Content-type: application/json ISCRYPT: 0 Response Format JSON
Request 필드 타입 필수 여부 설명 appid String O 앱 아이디 player_id Integer O 플레이어 아이디 hive_certification_key String O Hive 인증키(앱센터에서 발급)
Response 필드 타입 설명 result_code Integer 0: 정상 2002: 이용 정지 미등록 유저 4000: 유효하지 않은 파라미터 4002: Hive 인증키 불일치 6000: 유효하지 않은 appid result_msg String 결과 메시지
Request examples
curl -X POST https://auth.qpyou.cn/game/block/delete \
-H 'Content-Type: application/json' \
-H 'ISCRYPT: 0' \
-d '{"appid" : "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal", "player_id" : 24000000000, "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"}'
Response examples
{
"result_code": 0,
"result_msg": "SUCCESS"
}