게임 이용 정지 유저 확인하기

게임 이용 정지 유저 확인하기 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
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¶

    curl -X POST https://auth.qpyou.cn/game/block/get
    -H 'Content-Type: application/json'
    -H 'ISCRYPT: 0'
    -d '{"appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common", "player_id": 20000020208, "language": "ko", "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"}'

Response examples¶

성공 (정상 유저)¶

    {
    "result_code": 0,
    "result_msg": "SUCCESS",
    "data":{
        "is_blocked": false,
        "status": "N",
        "start_date": null,
        "end_date": null,
        "remaining_date": null,
        "reason": null
    }
  }

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

    {
    "result_code": 0,
    "result_msg": "SUCCESS",
    "data":{
        "is_blocked": true,
        "status": "B",
        "start_date": "2024-05-15 10:00:00",
        "end_date": "2024-06-30 23:59:59",
        "remaining_date": "27d 5hr 8min",
        "reason": "Temporary Restriction (Retrieve game money)"
    }
  }

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

{
    "result_code": 0,
    "result_msg": "SUCCESS",
    "data":{
        "is_blocked": true,
        "status": "P",
        "start_date": "2024-05-15 10:00:00",
        "end_date": "9999-12-31 00:00:00",
        "remaining_date": "Permanent",
        "reason": "Temporary Restriction (Retrieve game money)"
    }
  }

실패¶

    {
    "result_code": 4000,
    "result_msg": "Request has invalid format.",
    "data": "player_id"
  }