이용 정지 등록 및 해제¶

앱 운영 정책에 따라 Hive 서버에서 사용자 계정을 이용 정지 상태로 등록하거나 해제하는 API입니다.

'이용 정지 등록 및 해제' 기능으로 제공되는 API는 아래와 같습니다.

API Endpoint	설명
`POST /v2/game/block/set`	이용 정지 등록
`POST /v2/game/block/delete`	이용 정지 해제

이용 정지 등록¶

Hive 콘솔 또는 이용 정지 유형 등록 API를 통해 이용 정지 유형을 사전에 등록하면, 영구 이용 정지 사용자와 기간 제한이 있는 이용 정지 사용자를 구분해 등록할 수 있습니다. 또 기존에 등록한 사용자(PlayerID로 구분) 이용 정지 유형과 이용 정지 기간을 변경할 수 있습니다.

Request URL¶

상용 URL	https://auth.qpyou.cn/v2/game/block/set
Sandbox URL	https://sandbox-auth.qpyou.cn/v2/game/block/set
HTTP Method	POST
Content-Type	application/json
Data Format	JSON

Request header¶

필드명	설명	타입	필수여부
X-Access-Token	앱 서버 인증을 위한 OAuth 2.0 Access Token (OAuth Token 발급하기 참고)	String	Y
ISCRYPT	데이터 암호화 여부 (0 = 암호화 안 함) (무조건 0으로 전달)	Integer	Y

Request body¶

필드명	설명	타입	필수여부
appid	App ID	String	Y
player_id	Player ID	Integer	Y
status	이용 정지 상태 `P`: 영구 이용 정지 `B`: 이용 정지 기간이 있는 사용자	String	Y
block_type	이용 정지 유형 번호 [Hive 콘솔 > 인증 > 이용 정지 > 유형 등록] 또는 이용 정지 유형 등록 API에서 먼저 등록해야 합니다.	Integer	Y
start_date	이용 정지 시작일 (형식: `YYYY-MM-DD HH:mm:ss`)	String	Y
end_date	이용 정지 종료일 (형식: `YYYY-MM-DD HH:mm:ss`)	String	Y
skip_blocked	`true`로 요청하면 기존 차단 데이터가 이미 있는 경우 차단 데이터를 변경하지 않고 `result_code=0`을 반환합니다.	Boolean	N
did	앱 설치 시 생성되는 앱 식별자입니다. 동일한 종류의 앱을 식별할 때 사용합니다. SDK 초기화 시 새로 발급되거나 이미 존재하는 값을 반환받아 전달하면 해당 기기의 로그인 이력을 검증합니다.	Integer	N

Request example¶

기간 제한 이용 정지 사용자를 등록할 때는 status를 B로 지정하고 start_date, end_date를 함께 전달하세요.

{
    "appid": "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
    "player_id": 24000000000,
    "status": "B",
    "block_type": 18,
    "start_date": "2024-06-03 00:00:00",
    "end_date": "2024-06-30 23:59:59",
    "skip_blocked": true,
    "did": 2000000
}

Response body¶

필드명	설명	타입
result_code	응답 코드 자세히	Integer
result_msg	결과 메시지	String
token_validation	JWT 검증 결과 (JWT 검증 에러)	Object
token_validation.result_code	JWT 검증 결과 코드	Integer
token_validation.result_msg	JWT 검증 결과 메시지	String

응답 코드¶

코드값	설명
0	성공
2499	JWT 검증 실패 (token_validation 참고)
4000	유효하지 않은 파라미터 이용 정지 시작일과 종료일의 형식이 올바르지 않은 경우 시작일이 종료일보다 큰 경우 현재 시간이 종료일보다 큰 경우
4011	미등록 유형
4013	`did` 로그인 이력 검증 실패 (로그아웃 상태에서는 검증 불가)
6000	유효하지 않은 appid

Response example¶

성공¶

{
    "result_code": 0,
    "result_msg": "SUCCESS",
    "token_validation": {
        "result_code": 0,
        "result_msg": "success"
    }
}

이용 정지 해제¶

특정 계정이 이용 정지된 상태를 Hive 서버에서 직접 해제합니다.