获取国家代码

您可以获取请求 IP 的国家代码。当 IP 存在于请求 IP 字段时,请使用该 IP。如果没有任何内容,时区服务会检查请求客户端 IP 以返回相关的国家代码。

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

時間區域 API 擁有分散式處理環境,以應對故障或網路不良的情況。如果因故障或網路問題而超過為您的遊戲伺服器設置的通信超時,請使用分散式環境 URL 調用此 API。

  • 請求
欄位名稱 描述 必要
ip 如果請求的 IP(IPv4 或 IPv6)為空,則通過 API 實現客戶端的 IP 獲取國家代碼。 N
  • 回應
欄位名稱 描述 類型
result_code 結果代碼。0=成功 整數
result_msg 結果訊息 字串
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" 將作為 country_code 值返回。

  • 如果無法識別時區的回應範例
{ 
"result_code":0,
"result_message":"Success",
"timezone" : {
         "country_code":"UNKNOWN"
   } 
}