WHOIS OpenAPI
한국인터넷진흥원은 사용자의 WHOIS 검색 편의를 위해 OpenAPI를 제공해왔습니다.
2021년 11월 26일부터 WHOIS OpenAPI 서비스를 공공데이터포털(data.go.kr)과 연계하여 제공하고 있습니다.
※ WHOIS OpenAPI KEY를 이미 발급받은 사용자는 기존 방식대로 계속 사용 가능합니다.
신규로 WHOIS OpenAPI 이용을 원하는 사용자는 공공데이터포털(data.go.kr)을 이용해 주시기 바랍니다.
공공데이터포털 이용 시 WHOIS OpenAPI 트래픽 규모가 일일 1만건 에서 일일 최대 10만건까지 이용 가능합니다.
공공데이터포털(data.go.kr) WHOIS OpenAPI 신청방법
STEP1. WHOIS OpenAPI 검색
공공데이터포털에서 WHOIS OpenAPI 검색방법
- 1. 검색어를 입력하세요. ex) whois 도메인 IP 주소
- 2. 검색조건을 추가할 수 있습니다.
- 3. 검색결과를 확인하세요.
- 4. 검색결과에서 오픈 API 항목을 선택하세요.
- 5. 원하는 데이터를 찾았다면 데이터 목록 명을 클릭해보세요. 데이터목록 상세 화면으로 이동합니다.
STEP2-1. WHOIS OpenAPI 활용신청 - 개발계정 신청
개발계정 신청방법
- 오픈API 상세 화면에서 활용신청 버튼을 눌러 개발계정을 먼저 신청해 주세요.
- * 개발계정이란? OpenAPI를 활용해 서비스를 개발할 때 필요한 계정으로 하루 평균 1만건 규모의 트래픽을 제공합니다.
STEP2-2. WHOIS OpenAPI 활용신청 - 운영계정 신청
운영계정 신청방법
- 개발계정 상세화면에서 운영계정 신청 버튼을 눌러 운영계정을 신청해 주세요.
- * 운영계정이란? 개발된 서비스를 이용자가 사용하기 위한 계정으로 하루 최대 10만건의 트래픽을 제공합니다.
STEP3. WHOIS OpenAPI 활용 승인
개발계정과 운영계정 신청이 모두 끝났다면, OpenAPI 활용 신청에 대한 승인을 기다려주세요.
승인은 '자동승인'과 '심의승인' 두 가지 방법으로 진행됩니다.
* WHOIS OpenAPI 는 자동승인으로 처리되며 별도의 심의과정없이 사용 할 수 있습니다.
- 자동승인 : 별도 확인 없이 승인신청과 동시에 자동으로 승인되는 경우를 말합니다. 활용 신청 건에 대해 제공기관
담당자의 별도 확인 없이 신속하게 승인 처리를 받을 수 있습니다.
- 심의승인 : 신청 후 2~3일 후 결과 통보활용 신청 건에 대해 제공기관 담당자의 '승인'이 완료되어야 OpenAPI를 활용할 수 있습니다.
신청 후 보통 2~3일 정도 소요가 되며 승인 여부는 회원가입 시 등록한 이메일로 통보합니다.
STEP4. WHOIS OpenAPI 인증키 발급
활용신청 승인이 완료됐다면 활용신청 건에 대해 1인당 하나의 인증키를 발급받을 수 있습니다.
인증키 발급 확인
- 발급된 인증키는 공공데이터포털의 '마이페이지 > 오픈API > 개발계정 상세보기' 에서 확인 할 수 있습니다.
- 인증키는 Encoding된 인증키와 Decoding된 인증키 2종류가 발급됩니다.
- 두 인증키는 동일한 인증키이지만 API 환경 또는 API 호출 조건에 따라 인증키가 적용되는 방식이 달라질수 있어 두 종류의 인증키를 적절히 사용해야 합니다.
- 향후 명확한 지침은 공공데이터 포털에서 제공됩니다.
STEP5. WHOIS OpenAPI 서비스 이용
프로그램에 데이터 제공 주소(URL)와 OpenAPI 인증키를 입력한 뒤 API를 호출하면 원하는 데이터를 손쉽게 받아 서비스 개발에 활용할 수 있습니다.
OpenAPI 인증키와 URL을 기반으로 API 호출가능
- 호출예시 : https://apis.data.go.kr/B551505/whois/ipas_country_code?query=202.30.50.51&serviceKey=[발급받은 인증키]
-
<?xml version="1.0" encoding="UTF-8"> <response> <result> <result_code>10000</result_code > <result_msg><![CDATA[정상응답입니다.]]> </result> <whois> <query>202.30.50.51</query> <queryType>IPv4</queryType> <registry>KRNIC</registry> <countryCode>KR</countryCode> </whois> </response>
- 해당 OpenAPI 서비스 이름은 '인터넷주소자원(도메인이름, 아이피) 정보검색 서비스'이고 상세기능이름은 'IP주소/AS번호의 국가코드 조회'이며 정보의 제공기관은 '한국인터넷진흥원' 입니다.