이용 정지 유형 확인하기¶
등록된 이용 정지 유형 목록을 조회합니다. 운영 정책 제한 유형(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)
| String | N |
Request example¶
특정 언어 기준으로 팝업 문구를 확인해야 하면 language에 언어 코드를 넣어 요청하세요. type_name은 한국어 고정이고 type_en_name은 영어 고정입니다.
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_code가 0이면 data.block_type_list와 data.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 검증 에러 코드를 참고하세요.