국가코드 획득

요청 IP의 국가코드를 획득할 수 있습니다. 요청 데이터 IP 필드에 IP가 존재할 경우 해당 값을 이용하고, 없을 경우 요청 클라이언트의 IP를 판단하여 해당 IP의 국가코드 정보를 반환합니다.

  • Request URL
상용 URL https://timezone.qpyou.cn/public/api/getCountryCodeByIp
분산 환경 URL https://timezone.globalwithhive.com/public/api/getCountryCodeByIp
Sandbox URL https://sandbox-timezone.qpyou.cn/public/api/getCountryCodeByIp
HTTP Method POST
Content-Type text/html
Data Format JSON
Note

Hive 타임존 API는 장애가 발생하거나 네트워크가 원활하지 않을 경우를 대비해 분산 처리 환경을 갖추었습니다. 만약 장애나 네트워크 이상으로 여러분의 게임 서버에 설정한 통신 타임아웃을 초과하면 분산 환경 URL을 사용해 API를 호출하세요.

  • Request
필드명 설명 필수여부
ip 요청 IP(IPv4 또는 IPv6).
해당 값이 없을 경우 API를 호출한 클라이언트의 IP로 국가코드 정보를 획득		 N
  • Response
필드명 설명 타입
result_code 결과 코드. 0=성공 Integer
result_msg 결과 메시지 String
timezone Object 타입의 타임존
하단의 Timezone object 항목 참고		 Object
  • Timezone Object
필드명 설명 타입
country_code ISO 3166-1 alpha-2를 기준으로 삼은 국가 코드 String
  • Request Sample
//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"
}
  • Response Sample
{ 
"result_code":0,
"result_message":"Success",
"timezone" : {
         "country_code":"KR"
   } 
}
Note

IP의 국가코드가 식별되지 않는 경우 결과는 성공으로 반환되며, timezone의 country_code는 "UNKNOWN"으로 반환됩니다.

  • IP로 타임존이 식별되지 않는 경우 Response Sample
{ 
"result_code":0,
"result_message":"Success",
"timezone" : {
         "country_code":"UNKNOWN"
   } 
}