การตรวจสอบโทเคนการตรวจสอบสิทธิ์ v4

ตรวจสอบโทเค็น¶

หลังจากการเข้าสู่ระบบที่ประสบความสำเร็จในเกมไคลเอนต์ เซิร์ฟเวอร์เกมสามารถตรวจสอบความถูกต้องของคีย์โทเค็นของผู้ใช้ที่เข้าสู่ระบบผ่านโทเค็น, PlayerID, และ DID ในค่าผลลัพธ์ PlayerInfo ดังนั้น หากเกมของคุณไม่อนุญาตให้เข้าสู่ระบบซ้ำ ตรวจสอบให้แน่ใจว่าคุณจัดการคีย์โทเค็นที่ได้รับการตรวจสอบแล้ว หรือจัดการคีย์เซสชันจากด้านเกมเพื่อดำเนินการฟีเจอร์การเข้าสู่ระบบ

• Request URL

  URL ทั่วไป	https://auth.qpyou.cn/game/token/get-token
  URL สภาพแวดล้อมที่กระจาย	https://auth.globalwithhive.com/game/token/get-token
  URL Sandbox	https://sandbox-auth.qpyou.cn/game/token/get-token
  HTTP Method	Post
  Content-Type	text/html
  รูปแบบข้อมูล	JSON

• คำขอ Header

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  Authorization	คีย์โทเค็นที่ส่งคืนหลังจากลงชื่อเข้าใช้	String	Y
  ISCRYPT	ข้อมูลที่เข้ารหัส, 0=ไม่ได้เข้ารหัส	Integer	Y

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

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  appid	AppID ของเกมที่ผู้ใช้ลงชื่อเข้าใช้	String	ใช่
  did	DID ที่ส่งคืนหลังจากลงชื่อเข้าใช้	String	ใช่
  player_id	PlayerID ที่ส่งคืนของการตรวจสอบสิทธิ์ v4 หลังจากลงชื่อเข้าใช้	Integer	ใช่
  hive_certification_key	คีย์การรับรอง (ออกโดย AppCenter) ดูเพิ่มเติม	String	ไม่

• Response

  ชื่อฟิลด์	คำอธิบาย	ประเภท
  result_code	ผลการตรวจสอบ 0=สำเร็จ เพิ่มเติม…	จำนวนเต็ม
  result_msg	ข้อความผลลัพธ์	สตริง

• Request Sample<

  { 
  "appid":"com.withhive",
  "did":"255764404509548", 
  "player_id": 21,
  "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
  }
  

• Response Sample<

  { 
  "result_code":0,
  "result_message":"SUCCESS"
  }
  

• ข้อผิดพลาด รหัส

  ค่า	คำอธิบาย
  0	สำเร็จ
  2300	ต้องการการชำระคืนสำหรับรายการที่คืนเงิน
  4000	พารามิเตอร์ไม่ถูกต้อง
  4001	ข้อผิดพลาด json ของคำขอ
  4002	ข้อผิดพลาดของคีย์การรับรอง
  5000	ข้อผิดพลาด DB
  5001	โทเค็นไม่ถูกต้องในสภาพแวดล้อมที่กระจาย (AWS)
  6000	AppID ไม่ถูกต้อง
  6001	ข้อผิดพลาดโทเค็น IdP
  7000	โทเค็นไม่ถูกต้อง
  7001	ไม่มีโทเค็นในฟิลด์ส่วนหัว
  9999	ข้อผิดพลาดที่ไม่รู้จัก

ตรวจสอบโทเค็น คืนค่า IDP ID สำหรับ PlayerID¶

หลังจากเข้าสู่ระบบสำเร็จในชุมชนในเกม ให้ใช้โทเค็น, PlayerID, AppID, และ DID (โทเค็น Authorization, PlayerID, และ DID จะถูกส่งคืนใน PlayerInfo หลังจากเข้าสู่ระบบ) เพื่อตรวจสอบความถูกต้องของโทเค็นผู้ใช้ที่เข้าสู่ระบบ และรับรายการ IdP IDs ที่ correspond กับ PlayerID.

• คำขอ URL

  URL ของเซิร์ฟเวอร์เชิงพาณิชย์	https://auth.qpyou.cn/server/player/get-idpuserid
  URL ของสภาพแวดล้อมที่กระจาย	https://auth.globalwithhive.com/server/player/get-idpuserid
  URL ของ Sandbox	https://sandbox-auth.qpyou.cn/server/player/get-idpuserid
  HTTP Method	Post
  Content-Type	application/json
  รูปแบบข้อมูล	JSON

• คำขอ หัวข้อ

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  Authorization	โทเค็นที่ส่งกลับหลังจากเข้าสู่ระบบสำเร็จ	String	Y
  ISCRYPT	ข้อมูลที่เข้ารหัส, 0=ไม่เข้ารหัส	Integer	Y

• Request Body

  ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
  appid	AppID ของเกมที่ผู้ใช้ล็อกอินอยู่	String	Y
  did	DID ที่ส่งกลับหลังจากล็อกอินสำเร็จ	String	Y
  player_id	PlayerID ที่ส่งกลับหลังจากล็อกอินสำเร็จ	Integer	Y

• Request Body Example

  {
      "player_id": 20000016588,
      "appid" : "com.com2us.hivesdk.normal.freefull.google.global.android.common",
      "did" : 303581410
  }
  

• Response Body

  ชื่อฟิลด์	คำอธิบาย	ประเภท
  result_code	ผลลัพธ์การตรวจสอบ, 0: สำเร็จ 4000: ค่าพารามิเตอร์ไม่ถูกต้อง. 7000: การตรวจสอบล้มเหลว ค่าตัวตรวจสอบไม่ตรงกัน.	จำนวนเต็ม
  result_msg	ข้อความผลลัพธ์	สตริง
  data	ข้อมูลผลลัพธ์	JSON

• Response Body - data

  ชื่อฟิลด์	คำอธิบาย	ประเภท
  data.list	รายการข้อมูลผลลัพธ์	Array
  data.list.player_id	รหัส PlayerID ที่ร้องขอในเนื้อหาคำขอ	String
  data.list.idp_user_id	โทเค็นบัญชี (uid) ที่ส่งจาก IdP	String
  data.list.idp_index	idp_index 1: HIVE 2: Facebook 3: GOOGLE 9: APPLE	String

• Response Body Sample

  {
          "result_code": 0,
          "result_msg": "SUCCESS",
          "data": {
                  "list": [
                          {
                                  "player_id": "20000016588",
                                  "idp_user_id": "68101398",
                                  "idp_index": "1"
                          }
                  ]
          }
  }