การรับรหัสประเทศ

คุณสามารถรับรหัสประเทศของ IP ที่ร้องขอได้ เมื่อมี IP อยู่ในฟิลด์ IP ที่ร้องขอ ให้ใช้ IP นั้น หากไม่มีอะไรอยู่ บริการเขตเวลาจะตรวจสอบ IP ของไคลเอนต์ที่ร้องขอเพื่อคืนรหัสประเทศที่เกี่ยวข้อง

• URL การร้องขอ

URL ทั่วไป	https://timezone.qpyou.cn/public/api/getCountryCodeByIp
URL สภาพแวดล้อมที่กระจาย	https://timezone.globalwithhive.com/public/api/getTimezone
URL Sandbox	https://sandbox-timezone.qpyou.cn/public/api/getCountryCodeByIp
วิธีการ HTTP	POST
ประเภทเนื้อหา	text/html
รูปแบบข้อมูล	JSON

Note

API โซนเวลามีสภาพแวดล้อมการประมวลผลแบบกระจายกรณีที่เกิดความล้มเหลวหรือเครือข่ายไม่ดี หากการสื่อสารหมดเวลาที่ตั้งไว้สำหรับเซิร์ฟเวอร์เกมของคุณเกินกำหนดเนื่องจากความล้มเหลวหรือปัญหาเครือข่าย ให้เรียกใช้ API นี้โดยใช้ URL สภาพแวดล้อมแบบกระจาย

• ขอร้อง

ชื่อฟิลด์	คำอธิบาย	จำเป็น
ip	หาก IP ที่ร้องขอ (IPv4 หรือ IPv6) เป็น null ระบบจะดึงรหัสประเทศผ่าน IP ของไคลเอนต์ที่ใช้ API	N

• การตอบกลับ

ชื่อฟิลด์	คำอธิบาย	ประเภท
result_code	รหัสผลลัพธ์ 0=สำเร็จ	จำนวนเต็ม
result_msg	ข้อความผลลัพธ์	สตริง
timezone	โซนเวลาประเภทวัตถุ โปรดดู วัตถุ Timezone ต่อไปนี้	วัตถุ

• วัตถุเขตเวลา

ชื่อฟิลด์	คำอธิบาย	ประเภท
country_code	รหัสประเทศตาม ISO 3166-1 alpha-2	สตริง

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

//IPv4
{
    "ip" : "127.0.0.1"
}
//IPv6
{
    "ip" : "::ffff:dc46:52e7" or "0:0:0:0:0:ffff:dc46:52e7" or "0000:0000:0000:0000:0000:ffff:dc46:52e7"
}

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

{ 
"result_code":0,
"result_message":"Success",
"timezone" : {
         "country_code":"KR"
   } 
}

Note

เมื่อรหัสประเทศของ IP ที่ขอไม่สามารถระบุได้ จะส่งคืนค่าผลลัพธ์เป็นความสำเร็จ และส่งคืนค่า "UNKNOWN" เป็นค่ารหัสประเทศ

• ตัวอย่างการตอบกลับในกรณีที่ IP ไม่สามารถระบุเขตเวลาได้

{ 
"result_code":0,
"result_message":"Success",
"timezone" : {
         "country_code":"UNKNOWN"
   } 
}