이용 정지 등록 및 해제

이용 정지 등록

개발사 운영 정책에 따라 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"
}