获取时区

獲取請求 IP 的時區資訊和國家資訊。如果請求主體中的 ip 欄位沒有值，則返回調用此 API 的 IP 的時區和國家資訊。

請求網址

常用網址	https://timezone.qpyou.cn/public/api/getTimezone
分散式環境網址	https://timezone.globalwithhive.com/public/api/getTimezone
沙盒網址	https://sandbox-timezone.qpyou.cn/public/api/getTimezone
HTTP 方法	POST
內容類型	text/html
數據格式	JSON

Note

時間區域 API 在發生故障或網絡不佳的情況下具有分佈式處理環境。如果因故障或網絡問題而超過為您的遊戲伺服器設置的通信超時，請使用分佈式環境 URL 調用此 API。

請求主體

欄位名稱	描述	必填
ip	如果請求的 IP（IPv4 或 IPv6）為空，則通過 API 實現客戶端的 IP 獲取時區和國家數據。	N

回應

字段名称	描述	必需
result_code	结果代码。0=成功	整数
result_msg	结果消息	字符串
timezone	对象类型的时区参考以下时区对象	对象
country_diff	`true`: 使用的时区的国家代码与基于 `ip` 的地理位置的国家代码不相等 `false`: 使用的时区的国家代码与基于 `ip` 的地理位置的国家代码相等越南北部（`VN`）使用亚洲/曼谷时区，南部使用亚洲/胡志明市时区。顺便提一下，亚洲/曼谷时区的国家代码是泰国（`TH`）。基于 IP 的地理位置的越南北部的国家代码（`VN`）与越南北部使用的时区的国家代码（`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
}