การรับเขตเวลา

รับข้อมูลเขตเวลาและข้อมูลประเทศของ 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
  • true: รหัสประเทศของโซนเวลาที่ใช้โดย ip != รหัสประเทศตามตำแหน่งทางภูมิศาสตร์ของ ip
  • false: รหัสประเทศของโซนเวลาที่ใช้โดย ip == รหัสประเทศตามตำแหน่งทางภูมิศาสตร์ของ ip ภาคเหนือของเวียดนาม (VN) ใช้โซนเวลา Asia/Bangkok และภาคใต้ใช้โซนเวลา Asia/Ho_Chi_Minh โดยรหัสประเทศสำหรับโซนเวลา Asia/Bangkok คือประเทศไทย (TH) รหัสประเทศ (VN) ของภาคเหนือของเวียดนามตามตำแหน่งทางภูมิศาสตร์ของ IP และรหัสประเทศ (TH) ของโซนเวลาที่ใช้โดยภาคเหนือของเวียดนามแตกต่างกัน.
บูลีน
  • วัตถุเขตเวลา
ชื่อฟิลด์ คำอธิบาย ประเภท
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 ไม่สามารถระบุเขตเวลาได้
{
    "result_code": 0,
    "result_message": "Success",
    "timezone": {
        "zone_id": null,
        "country_code": "UNKNOWN",
        "zone_name": null,
        "country_name": null,
        "abbreviation": null,
        "gmt_offset": null,
        "dst": null
    },
    "country_diff": false
}