국가코드 획득

요청 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

• 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" }

  1 2 3 4 5 6 7 8 9 10

  //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" } }

  1 2 3 4 5 6 7

  { "result_code":0, "result_message":"Success", "timezone" : {          "country_code":"KR"    } }

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

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

  1 2 3 4 5 6 7

  { "result_code":0, "result_message":"Success", "timezone" : {          "country_code":"UNKNOWN"    } }