国コードの取得

リクエストIPの国コードを取得できます。リクエストIPフィールドにIPが存在する場合は、そのIPを使用します。何も存在しない場合、タイムゾーンサービスはリクエストクライアントIPをチェックして関連する国コードを返します。

  • リクエストURL
共通URL https://timezone.qpyou.cn/public/api/getCountryCodeByIp
分散環境URL https://timezone.globalwithhive.com/public/api/getTimezone
サンドボックスURL https://sandbox-timezone.qpyou.cn/public/api/getCountryCodeByIp
HTTPメソッド POST
コンテンツタイプ text/html
データフォーマット JSON
Note

タイムゾーンAPIは、障害やネットワークの問題が発生した場合に分散処理環境を持っています。ゲームサーバーの通信タイムアウトが障害やネットワークの問題により超過した場合は、分散環境のURLを使用してこのAPIを呼び出してください。

  • リクエスト
フィールド名 説明 必須
ip リクエスト元のIP(IPv4またはIPv6)がnullの場合、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値として返されます。

  • IPがタイムゾーンを特定できない場合のレスポンスサンプル
{ 
"result_code":0,
"result_message":"Success",
"timezone" : {
         "country_code":"UNKNOWN"
   } 
}