สอบถามรายการ IdP¶

ใช้Player IDและรหัสแอปที่ส่งคืนหลังจากการเข้าสู่ระบบสำเร็จจากไคลเอนต์แอปเพื่อดึงรายชื่อ IdP (ผู้ให้บริการข้อมูลประจำตัว) ที่เชื่อมโยงกับผู้เล่นจากเซิร์ฟเวอร์แอป API "รับรายการ IdP" ทำงานผ่านการสื่อสารแบบเซิร์ฟเวอร์ถึงเซิร์ฟเวอร์ โดยที่เซิร์ฟเวอร์แอปจะเรียกใช้เซิร์ฟเวอร์การตรวจสอบสิทธิ์ Hive โดยตรง เมื่อคำขอสำเร็จ ข้อมูล IdP ที่เชื่อมโยงจะถูกส่งกลับเป็นอาร์เรย์ในช่องข้อมูลของการตอบกลับ เมื่อทำการร้องขอ จำเป็นต้องมีพารามิเตอร์ App ID และ Player ID

URL คำขอ¶

URL การผลิต	https://auth.qpyou.cn/v2/game/player/get-idp
URL สภาพแวดล้อมแบบกระจาย	https://auth.globalwithhive.com/v2/game/player/get-idp
URL แซนด์บ็อกซ์	https://sandbox-auth.qpyou.cn/v2/game/player/get-idp
วิธี HTTP	POST
Content-Type	application/json
รูปแบบข้อมูล	JSON

Note

เซิร์ฟเวอร์การตรวจสอบสิทธิ์ Hive ได้รับการกำหนดค่าในสภาพแวดล้อมแบบกระจายเพื่อเตรียมพร้อมสำหรับความล้มเหลวหรือการสื่อสารเครือข่ายที่ไม่เสถียร
หากเกิดความล้มเหลวขณะสื่อสารกับโฮสต์เซิร์ฟเวอร์การตรวจสอบสิทธิ์ หรือหากเกินระยะหมดเวลาที่กำหนดไว้บนเซิร์ฟเวอร์แอป เซิร์ฟเวอร์แอปจะต้องเรียก URL ของสภาพแวดล้อมแบบกระจายโดยตรง (URL ทางเลือก)

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

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

## ขอเนื้อความ
ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
---	---	---	---
appid	รหัสแอป	String	Y
player_id	ID ผู้เล่นยืนยันตัวตนถูกส่งคืนหลังจากเข้าสู่ระบบสำเร็จ	BigInteger	Y

ขอตัวอย่าง¶

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

เนื้อหาการตอบสนอง¶

ชื่อฟิลด์	คำอธิบาย	ประเภท
result_code	รหัสตอบกลับ รายละเอียด	Integer
result_msg	ข้อความผลลัพธ์	String
token_validation	ผลการตรวจสอบ JWT (ข้อผิดพลาดการตรวจสอบ JWT)	Object
token_validation.result_code	รหัสผลลัพธ์การตรวจสอบ JWT	Integer
token_validation.result_msg	ข้อความผลการตรวจสอบ JWT	String
data	ข้อมูลรายการ IdP	Array
data[].seq	ผู้ใช้คีย์หลัก (PK)	BigInteger
data[].player_id	Player ID	BigInteger
data[].idp_user_id	ค่า ID ผู้ใช้ที่ระบุโดย IdP	String
data[].idp_index	หมายเลขเฉพาะ IdP รายละเอียด	Integer
data[].idp_id	ค่าสตริงของ IdP	String

รหัสผลลัพธ์¶

ค่าโค้ด	คำอธิบาย
0	ความสำเร็จ
2002	ไม่มีข้อมูลผู้ใช้
4000	พารามิเตอร์ไม่ถูกต้อง
2499	การตรวจสอบ JWT ล้มเหลว (ดู token_validation)

## ตัวอย่างการตอบกลับ
### ความสำเร็จ
`{ "result_code": 0, "result_msg": "SUCCESS", "token_validation": { "result_code": 0, "result_msg": "success" }, "data": [ { "seq": 10000000067, "player_id": 90000000062, "idp_user_id": "0", "idp_index": 0, "idp_id": "GUEST" }, { "seq": 10000000068, "player_id": 90000000062, "idp_user_id": "64646595", "idp_index": 1, "idp_id": "HIVE" } ] }`

การตรวจสอบ 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

ดัชนี IdP¶

สำหรับข้อมูลดัชนี IdP โปรดดูที่ รายการ IdP