이용 정지 등록

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

Response Example

이용 정지 해제

특정 계정이 이용 정지된 상태를 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

Response Examples