ตรวจสอบประเภทการระงับการใช้งาน¶

Retrieves the list of registered access restriction types. It returns operation policy restriction types (block_type_list) and temporary restriction types (temp_type_list) separately. Unregistered languages are displayed in English. See Authentication > Restriction > Type registration.

URL คำขอ¶

URL ใช้งานจริง	https://auth.qpyou.cn/v2/game/block/type/get
URL Sandbox	https://sandbox-auth.qpyou.cn/v2/game/block/type/get
วิธี HTTP	POST
Content-Type	application/json
รูปแบบข้อมูล	JSON

ส่วนหัวคำขอ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
X-Access-Token	OAuth 2.0 Access Token สำหรับการรับรองความถูกต้องของเซิร์ฟเวอร์แอป (ดู ออก OAuth Token)	String	Y
ISCRYPT	ข้อมูลถูกเข้ารหัสหรือไม่ (0 = ไม่เข้ารหัส) (ต้องส่ง 0 เสมอ)	Integer	Y

เนื้อหาคำขอ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
appid	App ID	String	Y
language	Language code (default: en) ko (Korean) en (English) ja (Japanese) zh-hans (Simplified Chinese) zh-hant (Traditional Chinese) de (German) fr (French) ru (Russian) es (Spanish) pt (Portuguese) id (Indonesian) th (Thai) vi (Vietnamese) it (Italian) tr (Turkish) ar (Arabic)	String	N

ตัวอย่างคำขอ¶

If you need to check popup text for a specific language, send the language code in language. type_name is always Korean, and type_en_name is always English.

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

เนื้อหาการตอบกลับ¶

ชื่อฟิลด์	คำอธิบาย	ประเภท
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	Operation policy restriction type list	Array
data.block_type_list[].block_type	Restriction type number	Integer
data.block_type_list[].type_status	Restriction popup type (`O`: operation policy restriction)	String
data.block_type_list[].type_name	Restriction type name (fixed to Korean regardless of requested `language`)	String
data.block_type_list[].type_en_name	Restriction type name (fixed to English regardless of requested `language`)	String
data.block_type_list[].reason	Restriction reason (returned by `language`; unregistered languages use English)	String
data.temp_type_list	Temporary restriction type list	Array
data.temp_type_list[].block_type	Restriction type number	Integer
data.temp_type_list[].type_status	Restriction popup type (`N`: temporary restriction)	String
data.temp_type_list[].type_name	Restriction type name (fixed to Korean regardless of requested `language`)	String
data.temp_type_list[].type_en_name	Restriction type name (fixed to English regardless of requested `language`)	String
data.temp_type_list[].title	Temporary restriction popup title (returned by `language`; unregistered languages use English)	String
data.temp_type_list[].reason	Temporary restriction popup message (returned by `language`; unregistered languages use English)	String

รหัสตอบกลับ¶

Code value	คำอธิบาย
0	สำเร็จ
2499	การตรวจสอบ JWT ล้มเหลว (ดู token_validation)
4000	พารามิเตอร์ไม่ถูกต้อง
6000	appid ไม่ถูกต้อง

ตัวอย่างการตอบกลับ¶

สำเร็จ¶

If the request succeeds and result_code is 0, both data.block_type_list and data.temp_type_list are returned.

{"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":"불법 프로그램 이용"}],"temp_type_list":[{"block_type":25,"type_status":"N","type_name":"임시 접속 제한(게임 데이터 수정)","type_en_name":"Temporary access restriction (game data modified)","title":"게임 이용에 불편을 드려 죄송합니다.","reason":"현재 게임 데이터를 수정하는 중입니다. 빠른 조치를 위해 최선을 다하겠습니다."}]}}

JWT validation failure¶

{
  "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 สำหรับรายละเอียด