ดึงข้อมูลผู้ใช้ด้วย API การตรวจสอบสิทธิ์ การดึงข้อมูลผู้ใช้ผ่าน API การตรวจสอบสิทธิ์ เป็น API ที่ถูกเรียกใช้เมื่อจำเป็นต้องตรวจสอบข้อมูลผู้ใช้แยกต่างหากหลังจากที่ทำการเข้าสู่ระบบเว็บเสร็จสิ้น.
ส่งคืนข้อมูลผู้ใช้ที่ตรงกับ IdP โดยใช้ค่าตอบกลับ appid, idp_index, และ idp_user_id จาก API การตรวจสอบการเข้าสู่ระบบและการดึงข้อมูลผู้ใช้
URL การร้องขอ Note Authentication v4 ถูกออกแบบมาเพื่อสร้างสภาพแวดล้อมที่กระจายตัวในกรณีที่เกิดความล้มเหลวหรือปัญหาการสื่อสารเครือข่าย หากความล้มเหลวหรือความผิดปกติในการสื่อสารเครือข่ายเกินเวลาที่กำหนดสำหรับเซิร์ฟเวอร์เกม สภาพแวดล้อมที่กระจายตัวจะต้องถูกเรียกใช้
ส่วนหัวคำขอ ชื่อฟิลด์ ประเภท คำอธิบาย จำเป็น ISCRYPT จำนวนเต็ม ว่าข้อมูลถูกเข้ารหัสหรือไม่ (0: ไม่เข้ารหัส) ใช่
เนื้อหาคำขอ ชื่อฟิลด์ ประเภท คำอธิบาย จำเป็น appid String รหัสแอป Y idp_index Integer ดัชนี IdP 1: Hive2: Facebook3: Google9: Apple Y idp_user_id String รหัสประจำตัวที่ไม่ซ้ำของ IdP Y hive_certification_key String รหัสการรับรองของ Hive (Hive Console > App Center > Project Management > Game Details > Basic Information > Hive Certification Key ) Y
ตัวอย่างเนื้อหาคำขอ {
"appid" : "com.com2us.hivesdk.normal.freefull.google.global.android.common" ,
"idp_index" : 1 ,
"idp_user_id" : "68101398" ,
"hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
}
เนื้อหาการตอบกลับ ชื่อฟิลด์ ประเภท คำอธิบาย หมายเหตุ result_code จำนวนเต็ม รหัสผลลัพธ์ result_msg สตริง ข้อความผลลัพธ์ data JSON ข้อมูลผลลัพธ์ data.enc_idp สตริง คีย์สำหรับเข้ารหัสข้อมูลใน Request Body โทเค็นใช้ครั้งเดียวสำหรับการเข้าสู่ระบบอัตโนมัติจากภายนอกบน PC data.player_id จำนวนเต็มขนาดใหญ่ PlayerID data.list อาเรย์ รายการ IdP ที่เชื่อมโยง รายการที่มีข้อมูลของ IdP ที่ผู้ใช้เชื่อมโยง data.list.seq จำนวนเต็มขนาดใหญ่ รายการ IdP ที่เชื่อมโยง - Seq คีย์ลำดับที่ใช้เฉพาะในกระบวนการตรวจสอบสิทธิ์ data.list.player_id จำนวนเต็มขนาดใหญ่ รายการ IdP ที่เชื่อมโยง - PlayerID data.list.idp_user_id สตริง รายการ IdP ที่เชื่อมโยง - รหัสประจำตัวที่ไม่ซ้ำของ IdP data.list.idp_index จำนวนเต็ม รายการ IdP ที่เชื่อมโยง - ดัชนี IdP 1: Hive2: Facebook3: Google9: Apple data.list.idp_id สตริง รายการ IdP ที่เชื่อมโยง - รหัส IdP GUEST ถูกสร้างขึ้นโดยค่าเริ่มต้นแม้ว่าจะเล่นด้วย IdP อื่น data.is_blocked บูลีน ว่าผู้ใช้ถูกบล็อกหรือไม่ true: ผู้ใช้ถูกบล็อกfalse: ผู้ใช้ปกติ data.is_refund บูลีน ว่าผู้ใช้ต้องชำระเงินคืนสำหรับการคืนเงินหรือไม่ true: ผู้ใช้ต้องชำระเงินคืนสำหรับการคืนเงินfalse: ผู้ใช้ไม่ต้องชำระเงินคืนสำหรับการคืนเงิน
รหัสผลลัพธ์ รหัสผลลัพธ์ คำอธิบาย 0 สำเร็จ 2002 ไม่มีข้อมูลผู้ใช้ 4000 พารามิเตอร์คำขอไม่ถูกต้อง
ตัวอย่างเนื้อหาการตอบกลับ (ข้อมูลผู้ใช้มีอยู่) {
"result_code" : 0 ,
"result_msg" : "SUCCESS" ,
"data" : {
"enc_idp" : "K+A4xduO7kf5OrJ/iDPqL0PtMxwu7wW8JSBO+JJwSDDmJLvIi/6LG7TyWXdEHr9RNHM+/QXwc0+Y9z2eSRg7oeBBHmpOajzF1iiaacbFom4CsNy2fItendset7T0i0WYdyLQih3z5mDjcct47+gg2ovbp6kWRY8D+aGq+ZgaKiyr0Hmb1xmbWY/7cl1FjXTm0Nl9CWhO418bJFdwOpi+bw==" ,
"player_id" : 20000016588 ,
"list" : [
{
"seq" : 25771 ,
"player_id" : 20000016588 ,
"idp_user_id" : "68101398" ,
"idp_index" : 1 ,
"idp_id" : "HIVE"
},
{
"seq" : 25772 ,
"player_id" : 20000016588 ,
"idp_user_id" : "0" ,
"idp_index" : 0 ,
"idp_id" : "GUEST"
}
],
"is_blocked" : false ,
"is_refund" : false
}
}
ตัวอย่างเนื้อหาการตอบกลับ (ไม่มีข้อมูลผู้ใช้) {
"result_code" : 2002 ,
"result_msg" : "No User" ,
"data" : {
"enc_idp" : "K+A4xduO7kf5OrJ/iDPqLyCHfP+L3wz0WTNVw5KHLCqYjqQ+shQ2P3mkgwYCMvlnPatzlSE5ZFINr5gEIxK14sg0N8kOPSjSCeQ9UGGt11OMrYsGTuys0KmPJ2ZU/UWVVxpP1Lxx1eS8VbYwLmoTG+HTw2vkocghs/ZOZ9rqisdBRprhp6Q6+lIjpaUzDa2yy2guM1WheuVzKGL5331HHgo557RqoyUzTc6Lkf8ArWZ/XSwi3ZmStmhz/U4thcIwiowqgV+Ecdb2+WmMZ1MgGT4Xvbxa4lqzToBC3nxDvi1d8TjgMaszVYoNct94WPBGvV6emg3GqiJG+0ZTGg53+mZad9ttkUpTnQXetz5UDTxe5NnFAYfffzBq3jkqfAB042eH21rE3uTVJq3HuO8i9t1LJwKFfkC7sjjuaKNWsjs="
}
}
ตัวอย่างเนื้อหาการตอบกลับ (ความล้มเหลว) {
"result_code" : 4000 ,
"result_msg" : "Request has invalid format." ,
"data" : "appid, idp_user_id, idp_index"
}