การรับเขตเวลา
รับข้อมูลเขตเวลาและข้อมูลประเทศของ IP ที่ทำการร้องขอ หากไม่มีค่าในฟิลด์ ip
ใน Request Body ข้อมูลเขตเวลาและข้อมูลประเทศของ IP ที่เรียกใช้ API นี้จะถูกส่งคืน
- URL ที่ร้องขอ
URL ทั่วไป | https://timezone.qpyou.cn/public/api/getTimezone |
---|---|
URL สภาพแวดล้อมที่กระจาย | https://timezone.globalwithhive.com/public/api/getTimezone |
URL แซนด์บ็อกซ์ | https://sandbox-timezone.qpyou.cn/public/api/getTimezone |
วิธีการ HTTP | POST |
ประเภทเนื้อหา | text/html |
รูปแบบข้อมูล | JSON |
Note
API โซนเวลามีสภาพแวดล้อมการประมวลผลแบบกระจายกรณีที่เกิดความล้มเหลวหรือเครือข่ายไม่ดี หากเวลาสื่อสารที่ตั้งไว้สำหรับเซิร์ฟเวอร์เกมของคุณเกินกำหนดเนื่องจากความล้มเหลวหรือปัญหาเครือข่าย ให้เรียก API นี้โดยใช้ URL สภาพแวดล้อมแบบกระจาย
- เนื้อหาคำขอ
ชื่อฟิลด์ | คำอธิบาย | จำเป็น |
---|---|---|
ip | หาก IP ที่ร้องขอ (IPv4 หรือ IPv6) เป็น null ระบบจะดึงข้อมูลเขตเวลาและประเทศผ่าน IP ของไคลเอนต์ที่ใช้งาน API | N |
- การตอบกลับ
ชื่อฟิลด์ | คำอธิบาย | จำเป็น |
---|---|---|
result_code | รหัสผลลัพธ์ 0=สำเร็จ | จำนวนเต็ม |
result_msg | ข้อความผลลัพธ์ | สตริง |
timezone | โซนเวลาประเภทวัตถุ อ้างอิงจาก วัตถุโซนเวลา ต่อไปนี้ | วัตถุ |
country_diff |
| บูลีน |
- วัตถุเขตเวลา
ชื่อฟิลด์ | คำอธิบาย | ประเภท |
---|---|---|
zone_id | ตัวระบุสถานที่ที่ให้โดยฐานข้อมูลเขตเวลา | สตริง |
country_code | รหัสประเทศตาม ISO 3166-1 alpha-2 | สตริง |
zone_name | ชื่อท้องถิ่น | สตริง |
country_name | ชื่อประเทศ | สตริง |
abbreviation | ตัวย่อของเวลามาตรฐานตามประเทศ | สตริง |
gmt_offset | ความแตกต่างของเวลา (หน่วย: วินาที) | สตริง |
dst | การใช้เวลาในฤดูร้อน | สตริง |
- ตัวอย่างคำขอ
//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"
}
- ตัวอย่างการตอบกลับ
//Example 1
{
"result_code": 0,
"result_message": "Success",
"timezone": {
"zone_id": "361",
"country_code": "VN", //location-based country code
"zone_name": "Asia/Bangkok", //name of timezone
"country_name": "Vietnam",
"abbreviation": "ICT",
"gmt_offset": "25200",
"dst": "0"
},
"country_diff": true //In the case of "Asia/Bangkok", the country code is TH, and the country code from IP geolocation is VN. Set to true because they are different to each other.
}
//Example 2
{
"result_code": 0,
"result_message": "Success",
"timezone": {
"zone_id": "212",
"country_code": "KR", //location-based country code
"zone_name": "Asia/Seoul", // Name of time zone
"country_name": "Korea, Republic of",
"abbreviation": "KST",
"gmt_offset": "32400",
"dst": "0"
},
"country_diff": false // In the case of "Asia/Seoul", the country code is KR and the country code from the IP geolocation is also KR, so set to false.
}
Note
เมื่อเขตเวลาของ IP ที่ร้องขอไม่สามารถระบุได้ ค่าผลลัพธ์จะถูกส่งคืนเป็นความสำเร็จ และ "UNKNOWN" จะถูกส่งคืนเป็นค่าของ country_code
- ตัวอย่างการตอบกลับในกรณีที่ IP ไม่สามารถระบุเขตเวลาได้