获取国家/地区代码

您可以获取请求 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"
   } 
}