콘텐츠로 이동

이용 정지 유형 확인하기

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


Request URL

상용 URL https://auth.qpyou.cn/v2/game/block/type/get
Sandbox URL https://sandbox-auth.qpyou.cn/v2/game/block/type/get
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
language 언어 코드 (기본값: en)
  • ko (한국어)
  • en (영어)
  • ja (일본어)
  • zh-hans (중국어 간체)
  • zh-hant (중국어 번체)
  • de (독일어)
  • fr (프랑스어)
  • ru (러시아어)
  • es (스페인어)
  • pt (포르투갈어)
  • id (인도네시아어)
  • th (태국어)
  • vi (베트남어)
  • it (이탈리아어)
  • tr (터키어)
  • ar (아랍어)
String N


Request example

특정 언어 기준으로 팝업 문구를 확인해야 하면 language에 언어 코드를 넣어 요청하세요. type_name은 한국어 고정이고 type_en_name은 영어 고정입니다.

{
  "appid": "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
  "language": "ko"
}


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
data 결과 데이터 Object
data.block_type_list 운영 정책 제한 유형 목록 Array
data.block_type_list[].block_type 이용 정지 유형 번호 Integer
data.block_type_list[].type_status 이용 정지 팝업 형식 (O: 운영 정책 제한) String
data.block_type_list[].type_name 이용 정지 유형명 (요청한 language와 무관하게 한국어 고정) String
data.block_type_list[].type_en_name 이용 정지 유형명 (요청한 language와 무관하게 영어 고정) String
data.block_type_list[].reason 이용 정지 사유 (language 기준으로 반환, 미등록 언어는 영어) String
data.temp_type_list 임시 제한 유형 목록 Array
data.temp_type_list[].block_type 이용 정지 유형 번호 Integer
data.temp_type_list[].type_status 이용 정지 팝업 형식 (N: 임시 제한) String
data.temp_type_list[].type_name 이용 정지 유형명 (요청한 language와 무관하게 한국어 고정) String
data.temp_type_list[].type_en_name 이용 정지 유형명 (요청한 language와 무관하게 영어 고정) String
data.temp_type_list[].title 임시 제한 팝업 제목 (language 기준으로 반환, 미등록 언어는 영어) String
data.temp_type_list[].reason 임시 제한 팝업 안내 메시지 (language 기준으로 반환, 미등록 언어는 영어) String

응답 코드

코드값 설명
0 성공
2499 JWT 검증 실패 (token_validation 참고)
4000 유효하지 않은 파라미터
6000 유효하지 않은 appid


Response example

성공

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

{
  "result_code": 0,
  "result_msg": "SUCCESS",
  "token_validation": {
    "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": "현재 게임 데이터를 수정하는 중입니다. 빠른 조치를 위해 최선을 다하겠습니다."
      }
    ]
  }
}

JWT 검증 실패

{
    "result_code": 2499,
    "result_msg": "JWT validation failed. See token_validation for details.",
    "token_validation": {
        "result_code": 2408,
        "result_msg": "The access token is expired. Please refresh your token."
    }
}
Note

JWT 검증 실패 시, token_validation 필드로 상세 에러 정보를 확인할 수 있습니다. 자세한 내용은 JWT 검증 에러 코드를 참고하세요.