게임 이용 정지 유저 확인하기 API는 커뮤니티, 게임 웹페이지 등에서 웹 로그인으로 로그인을 시도 시, 이용이 정지된 유저를 알려줍니다.

Basics

  설명
Request URL
  • 상용: https://auth.qpyou.cn/game/block/get
  • 샌드박스: https://sandbox-auth.qpyou.cn/game/block/get
Method POST
HTTP Header Content-type: application/json
ISCRYPT:0
Response Format JSON

Request

명칭 타입 필수 여부 설명
appid String O 앱 아이디
player_id Integer O 플레이어 아이디
language String X

언어값입니다. 입력하지 않으면 영어로 설정됩니다.

  • ko (한국어)
  • en (영어)
  • ja (일본어)
  • zh-hans (중국어 간체)
  • zh-hant (중국어 번체)
  • de (독일어)
  • fr (프랑스어)
  • ru (러시아어)
  • es (스페인어)
  • pt (포르투칼어)
  • id (인도네시아어)
  • th (태국어)
  • vi (베트남어)
  • it (이탈리아어)
  • tr (터키어)
  • ar (아랍어)
hive_certification_key String O Hive 인증키(앱센터에서 발급)

Response

명칭 타입 설명 비고
result_code Integer 결과 코드
  • 0: 정상
  • 4000: 유효하지 않은 파라미터
  • 4002: Hive 인증키 불일치
  • 6000: 유효하지 않은 appid

* 유효하지 않음: 값이 없거나, null 값. 유효하지 않은 게임, 회사 결과 코드를 받으면 Hive 콘솔 앱센터에서 게임과 회사를 다시 설정해야 함.
result_msg String 이용 정지 사유 결과 메시지
data Object 결과 데이터
data.is_blocked Boolean 이용 정지 여부
  • true: 이용 정지 유저
  • false: 정상 유저
data.status String 이용 정지 상태
  • N: 정상 유저
  • P: 영구 이용 정지 유저
  • B: 이용 정지 기간이 있는 이용 정지 유저
data.start_date String 이용 정지 시작일
data.end_data String 이용 정지 종료일
data.remaining_date String 이용 정지 남은 일수 language 해당 언어로 표기(기본값: 영어)
data.reason String 이용 정지 사유 language 해당 언어로 표기(기본값: 영어)

Request Examples

Response Examples

성공 (정상 유저)

성공 (이용 정지 기간이 있는 이용 정지 유저)

성공 (영구 이용 정지 유저)

실패