การรับเขตเวลา
รับข้อมูลเขตเวลาและข้อมูลประเทศของ 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 ไม่สามารถระบุเขตเวลาได้