이용 정지 유형 확인하기

이용 정지 유형 확인하기¶

등록된 이용 정지 유형 목록을 조회합니다. 운영정책 제한 유형(block_type_list)과 임시 제한 유형(temp_type_list)을 구분하여 반환합니다. 미등록 언어는 영어로 표시됩니다. 인증 > 이용 정지 > 유형 등록을 참고하세요.

Basics¶

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

Request¶

Parameter	Type	Required	Description
appid	String	O	앱 아이디
hive_certification_key	String	O	Hive 인증키(앱센터에서 발급) 자세히
language	String	X	언어 코드 (기본값: en) ko (한국어) en (영어) ja (일본어) zh-hans (중국어 간체) zh-hant (중국어 번체) de (독일어) fr (프랑스어) ru (러시아어) es (스페인어) pt (포르투갈어) id (인도네시아어) th (태국어) vi (베트남어) it (이탈리아어) tr (터키어) ar (아랍어)

Response¶

Parameter	Type	Description
result_code	Integer	결과 코드 0: 정상 4000: 유효하지 않은 파라미터 4002: 인증키 불일치 6000: 유효하지 않은 appid
result_msg	String	결과 메시지
data	Object	결과 데이터
data.block_type_list	Array	운영정책 제한 유형 목록
data.block_type_list[].block_type	Integer	이용 정지 유형 번호
data.block_type_list[].type_status	String	이용 정지 팝업 형식 (`O`: 운영정책 제한)
data.block_type_list[].type_name	String	이용 정지 유형명 (요청한 `language`와 무관하게 한국어 고정)
data.block_type_list[].type_en_name	String	이용 정지 유형명 (요청한 `language`와 무관하게 영어 고정)
data.block_type_list[].reason	String	이용 정지 사유 (`language` 기준으로 반환, 미등록 언어는 영어)
data.temp_type_list	Array	임시 제한 유형 목록
data.temp_type_list[].block_type	Integer	이용 정지 유형 번호
data.temp_type_list[].type_status	String	이용 정지 팝업 형식 (`N`: 임시 제한)
data.temp_type_list[].type_name	String	이용 정지 유형명 (요청한 `language`와 무관하게 한국어 고정)
data.temp_type_list[].type_en_name	String	이용 정지 유형명 (요청한 `language`와 무관하게 영어 고정)
data.temp_type_list[].title	String	임시 제한 팝업 제목 (`language` 기준으로 반환, 미등록 언어는 영어)
data.temp_type_list[].reason	String	임시 제한 팝업 안내 메시지 (`language` 기준으로 반환, 미등록 언어는 영어)

특정 언어 기준으로 팝업 문구 요청하기¶

운영 도구에서 기본값 영어 대신 특정 언어 기준의 title과 reason 문구를 확인해야 하면 language에 언어 코드를 넣어 요청하세요. type_name은 한국어 고정이고 type_en_name은 영어 고정입니다. 이 API는 인증이 필요하므로 hive_certification_key를 함께 전달하세요.

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

운영정책 제한과 임시 제한 유형을 함께 받는 응답 확인하기¶

요청이 성공해 result_code가 0이면 data.block_type_list와 data.temp_type_list가 함께 반환됩니다. 서버에서 두 배열을 분리해 파싱하고, 각 유형의 이름과 사유를 목적에 맞게 사용하세요.

{
  "result_code": 0,
  "result_msg": "SUCCESS",
  "data": {
    "block_type_list": [
      {
        "block_type": 1,
        "type_status": "O",
        "type_name": "불법 프로그램 이용",
        "type_en_name": "Usage of unauthorized programs",
        "reason": "불법 프로그램 이용"
      },
      {
        "block_type": 2,
        "type_status": "O",
        "type_name": "비매너 행위",
        "type_en_name": "Inappropriate Behavior",
        "reason": "비매너 행위"
      }
    ],
    "temp_type_list": [
      {
        "block_type": 25,
        "type_status": "N",
        "type_name": "임시 접속 제한(게임 데이터 수정)",
        "type_en_name": "Temporary access restriction (game data modified)",
        "title": "게임 이용에 불편을 드려 죄송합니다.",
        "reason": "현재 게임 데이터를 수정하는 중입니다. 빠른 조치를 위해 최선을 다하겠습니다."
      }
    ]
  }
}