Korea Intellectual Property Strategy Institute 목차 1장 RIPIS 오픈서비스소개 1 1. 개요 3 2. 서비스콘텐츠 4 3. 이용절차 5 4. 인증키신청및관리 5 제2장 RIPIS 오픈서비스 11 1. 일반사용자 (Excel 활용 ) 안내 13 2. OPEN-API 안내 15 2.1. 정부 R&D 출처기재정보 API 15 2.2. 과제성과정보 API 17 2.3. 특허 > 서지정보 API 19 2.4. 특허 > 출원인정보 API 21 2.5. 특허 > 발명자정보 API 23 2.6. 특허 > IPC 정보 API 25 2.7. 특허 > 상태정보 API 27 2.8. 특허 > 질적정보 API 29 2.9. 특허 > 원문정보 API 31 제 3 장 OPEN-API JAVA 예제코드 33 1. OPEN-API JAVA 예제코드 35 제 4 장 OPEN-API 코드정보 41 1. OPEN-API 코드정보 43
서비스개발자매뉴얼 오픈 제 1 장 RIPIS 오픈서비스개요 Korea Intellectual Property Strategy Institute
제 1 장 오픈서비스개요 Ⅱ 콘텐츠 RIPIS 오픈서비스제공콘텐츠 - 특허청출원시출처기재정보 Ⅰ 오픈서비스소개 R&D 특허성과과제출처정보 출원번호, 과제고유번호, 부처명, 연구관리전문기관, 연구사업명, 연구과제명, 기여율, 주관기관, 연구기간 10 ~ 현재 74,336 건 정부R&D특허성과관리시스템 ( 이하, RIPIS) 오픈서비스를통하여 " 과제정보 ( 정부R&D출처기재정보 )API, 국내특허출원정보 API, 정부R&D특허성과정보 API, 특허평가정보 API" 를제공하고있습니다. RIPIS Open-API 서비스는표준프로토콜인 HTTP 를기반으로제공되고, 결과데이터전송은 XML로제공하여사용자가원하는형식또는디자인으로데이터를재가공및서비스할수있는정부 R&D 연구성과특허정보를제공합니다. RIPIS 오픈서비스 OPEN-API 종류 정부 R&D 성과정보 - 06 년이후정부 R&D 확정성과정보 정부 R&D 성과정보 과제고유번호, 출원 / 등록구분, 부처명, 조분대상사업명, 세부과제명, 성과제출연도, 기여율, 연구개발단계, 6T 분류, 특허정보 특허청의 06 년이후특허출원정보 특허서지정보 출원번호, 출원일자, 등록번호, 등록일자, 발명의명칭, 대표출원인, 대표발명자, 대표 IPC 정보, WIPO 기술분류 06 ~ 13 127,728 건 06 ~ 13 127,728 건 출원인정보출원번호, 출원인명, 출원인코드 06 ~ 13 1,450,947 건 발명자정보출원번호, 발명자명 06 ~ 13 3,242,256 건 IPC 정보출원번호, IPC 코드 06 ~ 13 2,879,923 건 특허상태정보출원번호, 심사결과, 현재상태, 거절이유, 소멸일자, 소멸이유 06 ~ 13 1,322,686 건 특허평가정보 06 년이후등록특허대상평가정보 특허평가정보 출원번호, 해외출원여부, 패밀리특허번호, 패밀리국가수, 패밀리국가 ( 지수 ), 청구항수, 청구항 ( 지수 ), 피인용수, 피인용 ( 지수 ), 범용성 ( 지수 ), PQI, PQI 등급 06 ~ 13 417,439 건 RIPIS 오픈서비스제공 OPEN-API 특허정보 OPEN-API 명칭 출처기재정보 API 성과과제정보 API 서지정보 API 출원인정보 API 발명자정보 API IPC 정보 API 상태정보 API 질적정보 API 원문정보 API 소개 정부R&D 특허성과정보의출원시기재된출처기재정보제공 정부R&D 특허성과의확정된성과정보제공 국내특허서지정보제공 국내특허출원인정보제공 국내특허발명자정보제공 국내특허 IPC정보제공 국내특허상태정보제공 '06년이후출원된국내등록특허의평가정보제공 국내특허의공개공보및공고공보원문정보제공 3 4
Ⅲ 및회원가입절차 오픈서비스이용절차 RIPIS 오픈서비스의 API는표준프로토콜인 HTTP를기반으로제공되고, 결과데이터전송은 XML로제공하여사용자가원하는형식또는디자인으로데이터를재가공및서비스할수있습니다. - RIPIS 오픈서비스는아래와같은절차로오픈 API 서비스를이용하실수있습니다. RIPIS 서비스의기존회원의경우 RIPIS 오픈서비스상단의로그인버튼을클릭하여로그인후, RIPIS 오픈서비스를이용하실수있습니다. - RIPIS 서비스의비회원인경우오픈서비스상단의회원가입버튼을클릭하여회원가입후, RIPIS 오픈서비스를이용하실수있습니다. - RIPIS 서비스회원가입클릭 - RIPIS 서비스는일반사용자와기관사용자 ( 부처, 과제관리기관, 연구기관 ) 로구분하여회원가입할수있습니다. - RIPIS 서비스는회원구분 ( 일반사용자또는기관사용자 ) 를선택한후, 아래의 아이핀인증 버튼을클릭합니다. Ⅳ 인증키신청및관리 STOP 01 ( 회원가입및로그인 ) - RIPIS 오픈서비스는 RIPIS 서비스의회원체계를활용하므로, RIPIS(www.ripis.or.kr) 시스템의회원가입또는회원로그인을필요로합니다. - RIPIS 서비스회원가입은아이핀인증을통하여개인에대한실명인증을수행합니다. - RIPIS 서비스로그인또는회원가입절차는아래와같습니다. 5 6
및회원가입절차 02 ( 서비스키발급및 API 신청 ) 서비스발급은 RIPIS(www.ripis.or.kr) 시스템에회원가입하신사용자를대상으로 발급하며, API 종류별사용을위한 API 신청이가능합니다. 서비스이용약관및개인정보처리방침에대한동의처리 - 필수입력항목을입력하고, 가입완료 버튼를클릭하여회원가입을완료합니다. STOP 03 (API 사용승인 ) < RIPIS 오픈서비스 API 사용승인요청 > - 사용자의필요에의한각 API 별신청을통하여, 시스템의관리자는간단한확인후에 API 서비스에대한승인처리를합니다. 승인된 API 에한하여, ServiceKey 를이용하여 OPEN-API 서비스를받으실수있습니다. - RIPIS 오픈서비스 (http://www.rndip.or.kr/opensvc/) 로접속하여, 상단의로그인버튼을클릭하여로그인할수있습니다. < RIPIS 오픈서비스 ServiceKey 발급정보및 API 별승인현황 > 7 8
04 ( 오픈 API 사용 ) 발급된서비스키를이용, 사용승인된 API 를아래의 URI 와같이이용, 오픈 API 서비스를 이용할수있습니다. URL 예시 http://www.rndip.or.kr/openapi/rest/pjtlistrequest?servicekey= searchfield=govdnm&query= 교육 는할당받은서비스키입력 &pageno=1&numofrows=10& 요청 URL 의결과정보 9 10
오픈 제 2 장 RIPIS 오픈서비스 Korea Intellectual Property Strategy Institute
제 2 장 오픈서비스 Excel 샘플파일오픈및매크로보안해제 - 다운로드된 Excel 샘플파일오픈시, Microsoft Excel의 RIPIS 오픈서비스 를정상적으로동작하기위해서보안경고에따른매크로사용에대한 이콘텐츠사용 조치를통하여보안해제가필요합니다. Ⅰ 사용자 (Excel 활용 ) 안내 오픈서비스중 Excel 의 Vba 프로그래밍을이용하여, 사용자에게익숙한 Excel UI를이용하여특허성과정보를활용할수있는서비스를제공합니다. RIPIS 오픈서비스의 VBA Sample Excel 파일은, RIPIS 오픈서비스에서제공하는 API로접근을통한검색및 Excel상의 Sheet로의데이터를출력하는샘플함수를구현한기능을제공하고있습니다. - RIPIS 오픈서버스홈 > 오픈 API > 출처기재정보 API > 샘플예제 에서제공하는 Excel VBA Application 샘플파일을다운로드 ( 아래그림 ) 하여 RIPIS 오픈서비스를제공 받을수있습니다. Excel VBA Application 샘플파일다운로드 파일다운로드 비주얼베이직포애플리케이션 (Visual Basic for Applications, VBA) 는마이크로소프트의이벤트반응형프로그래밍언어인비주얼베이직 6 의구현과관련된통합개발환경 (IDE) 이며, 이것은대부분마이크로소프트오피스응용프로그램 (Excel, Word, PowerPoint) 에내장되어있습니다. VBA 는개발자및 MS-OFFICE 파워유저들이사용자정의함수들을구축하게할수있고, 과정을자동화하고 Win32 와다른낮은 - 수준의기능을 DLL 들을통해접근할수있는인터페이스를제공합니다. Excel RIPIS 오픈서비스활용 < Excel 매크로보안해제 > - 정부 R&D 출처기재정보 API 활용을위하여 Excel 파일오픈후, 노란색바탕의셀에 할당받은 서비스키, 검색필드, 검색키워드 정보 ( 요청파라메터참조 ) 를입력하여 실행 버튼을클릭합니다. Excel 양식에서의검색 OPEN-API 별요청파라메터참조 서비스키 : RIPIS 오픈서비스에서할당받은 ServiceKey 값 - 검색필드 ( 검색대상필드선택 ) : 출원번호 : APPLNO 과제고유번호 : PJTINHNO 부처명 : GOVDNM 연구관리전문기관명 : RDCTRORG 주관기관명 : CNDORG 연구사업명 : RDBSNNM 연구과제명 : RDPJTNM - 검색키워드 : 검색필드에따른검색키워드정보 - 출력레코드수 : 10 ~ 100 까지입력가능 - 페이지번호 : 검색결과에대한페이지번호 13 14
RIPIS 오픈서비스검색정보정부 R&D 출처기재정보 API 활용을위하여 Excel 파일오픈후, 특정출원번호에대한검색결과는아래와같은 Excel Result Sheet에출력됩니다. < 특정출원번호에대한검색결과화면 > 요청변수값형식 searchfield 문자열 ( 필수 ) 조회하고자하는필드명을입력합니다. 출원번호 : APPLNO 과제고유번호 : PJTINHNO 부처명 : GOVDNM 연구관리전문기관명 :RDCTRORG 주관기관명 : CNDORG 연구사업명 : RDBSNNM 연구과제명 : RDPJTNM query 문자열 ( 필수 ) 검색어를입력합니다. numofrows Integer 결과 ROW 의개수를지정합니다. (default : 10, 최대 : 100 ) pageno Integer 결과에대한페이지번호를지정합니다.(1 or 2 or 3...) Ⅱ 안내 한국지식재산전략원의정부 R&D 특허성과정보및특허정보에대한 OPEN-API 활용을위한사용방법을안내합니다. 1 R&D 출처기재정보 API 구분 Operation URL 주요제공정보 인터페이스 PjtListRequest 값형식 항목 http:// www.rndip.or.kr/openapi/rest/pjtlistrequest 출원번호, 출원번호별순번, 등록번호, 과제고유번호, 부처명, 연구사업명, 연구과제명, 주관기관명, 연구기간, 연구관리전문기관명, 기여율 - RIPIS 오픈서비스는 REST 방식의 UTF-8 문자셋환경을지원합니다. 요청파라메터 문자열 ( 필수 ) 발급받은서비스키값을입력합니다. 응답구조 (XML) 응답엘리먼트 값형식 <response> <header> <resultcode> 문자열 검색결과코드를출력합니다. <resultmsg> 문자열 검색결과메시지를출력합니다. <body> <numofrows> Integer 페이지별건수 <pageno> Integer 페이지번호 <totalcount> Integer 전체검색결과수 <items> <item> <applno> 문자열 출원번호 <seq> Integer 출원번호별순번 <rgstno> 문자열 등록번호 <pjtinhno> 문자열 과제고유번호 <govdnm> 문자열 부처명 <rdbsnnm> 문자열 연구사업명 <rdpjtnm> 문자열 연구과제명 <cndorg> 문자열 주관기관명 <rddur> 문자열 연구기간 <rdctrorg> 문자열 연구관리전문기관명 <ctbr> 문자열 기여율 15 16
2 API 구분 항목 응답구조 (XML) 응답엘리먼트값형식 <response> Operation URL 주요제공정보 PatentResultListRequest http:// www.rndip.or.kr/openapi/rest/patentresultlistrequest 출원번호, 과제고유번호, 세부과제번호, 출원 (A)/ 등록 (R) 성과구분, 부처명, 연구관리전문기관명, 연구주관기관명, 연구사업명, 연구과제명, 성과제출연도, 연구기간, 기여율, 연구개발단계명, 6T 분류명 <header> <resultcode> 문자열 검색결과코드를출력합니다. <resultmsg> 문자열 검색결과메시지를출력합니다. <body> <numofrows> Integer 페이지별건수 <pageno> Integer 페이지번호 <totalcount> Integer 전체검색결과수 <items> RIPIS 오픈서비스는 REST 방식의 UTF-8 문자셋환경을지원합니다. 요청파라메터 값형식 searchfield 문자열 ( 필수 ) 문자열 ( 필수 ) 발급받은서비스키값을입력합니다. 조회하고자하는필드명을입력합니다. 출원번호 : APPLNO 과제고유번호 : PJTINHNO 부처명 : GOVDNM 세부과제명 : DETPJTNM query 문자열 ( 필수 ) 검색어를입력합니다. <item> <applno> 문자열 출원번호 <pjtinhno> Integer 과제고유번호 <detpjtno> 문자열 세부과제번호 <applrgsttp> 문자열 출원 (A)/ 등록 (R) 성과구분 <govdnm> 문자열 부처명 <rdctrproforgnm> 문자열 연구관리전문기관명 <cndorgnm> 문자열 연구주관기관명 <urgtrgtbsnnm> 문자열 연구사업명 <detpjtnm> 문자열 연구과제명 <pjtyear> 문자열 성과제출연도 numofrows Integer 결과 ROW 의개수를지정합니다. (default : 10, 최대 : 100 ) <rddur> 문자열연구기간 <ctbr> 문자열기여율 pageno Integer 결과에대한페이지번호를지정합니다.(1 or 2 or 3...) <rdpjstep> 문자열연구개발단계명 <t6reltcnrg> 문자열 6T 분류명 17 18
3 > 서지정보 API 구분 항목 응답구조 (XML) 응답엘리먼트값형식 <response> Operation URL 주요제공정보 PatentListRequest http:// www.rndip.or.kr/openapi/rest/patentlistrequest 출원번호, 출원일자, 공개번호, 공개일자, 등록번호, 등록일자, 발명의명칭, 대표출원인명, 대표발명자명, 대표권리인명, 대표 IPC 코드, wipo 대분류명, wipo 소분류명 <header> <resultcode> 문자열 검색결과코드를출력합니다. <resultmsg> 문자열 검색결과메시지를출력합니다. <body> <numofrows> Integer 페이지별건수 <pageno> Integer 페이지번호 <totalcount> Integer 전체검색결과수 RIPIS 오픈서비스는 REST 방식의 UTF-8 문자셋환경을지원합니다. <items> <item> 요청파라메터 값형식 문자열 ( 필수 ) 발급받은서비스키값을입력합니다. <applno> 문자열 출원번호 <appldt> 문자열 출원일자 <opnno> 문자열 공개번호 <opndt> 문자열 공개일자 <rgstno> 문자열 등록번호 searchfield 문자열 ( 필수 ) 조회하고자하는필드명을입력합니다. 출원번호 : APPLNO 등록번호 : RGSTNO 발명의명칭 : INVNTOFTTL 대표출원인명 : APPLNM 대표 IPC 코드 : IPCCD <rgstdt> 문자열 등록일자 <invntofttl> 문자열 발명의명칭 <applnm> 문자열 대표출원인명 <invntnm> 문자열 대표발명자명 <righnm> 문자열 대표권리인명 <ipccd> 문자열 대표 IPC 코드 query 문자열 ( 필수 ) 검색어를입력합니다. <wipocdnm> 문자열 wipo 대분류명 numofrows Integer 결과 ROW 의개수를지정합니다. (default : 10, 최대 : 100 ) <wiposmallcdnm> 문자열 wipo 소분류명 pageno Integer 결과에대한페이지번호를지정합니다.(1 or 2 or 3...) 19 20
4 > 출원인정보 API 구분 항목 응답구조 (XML) 응답엘리먼트값형식 Operation URL 주요제공정보 PatentApplListRequest http:// www.rndip.or.kr/openapi/rest/patentappllistrequest 출원번호, 출원일자, 등록번호, 등록일자, 순번, 출원인코드, 출원인명, 출원인영문명 <response> <header> <resultcode> 문자열 검색결과코드를출력합니다. <resultmsg> 문자열 검색결과메시지를출력합니다. <body> <numofrows> Integer 페이지별건수 RIPIS 오픈서비스는 REST 방식의 UTF-8 문자셋환경을지원합니다. 요청파라메터 <pageno> Integer 페이지번호 <totalcount> Integer 전체검색결과수 <items> 값형식 <item> 문자열 ( 필수 ) 발급받은서비스키값을입력합니다. <applno> 문자열출원번호 <appldt> 문자열출원일자 searchfield 문자열 ( 필수 ) 조회하고자하는필드명을입력합니다. 출원번호 : APPLNO <rgstno> 문자열등록번호 <rgstdt> 문자열등록일자 query 문자열 ( 필수 ) 검색어를입력합니다. <seq> Integer 순번 <applcd> 문자열출원인코드 numofrows Integer 결과 ROW 의개수를지정합니다. (default : 10, 최대 : 100 ) <applkrnm> 문자열출원인명 <applennm> 문자열출원인영문명 pageno Integer 결과에대한페이지번호를지정합니다.(1 or 2 or 3...) 21 22
5 > 발명자정보 API 구분 항목 응답구조 (XML) 응답엘리먼트값형식 Operation URL 주요제공정보 PatentInvntListRequest http:// www.rndip.or.kr/openapi/rest/patentinvntlistrequest 출원번호, 순번, 발명자명, 발명자국가명 <response> <header> <resultcode> 문자열 검색결과코드를출력합니다. <resultmsg> 문자열 검색결과메시지를출력합니다. <body> <numofrows> Integer 페이지별건수 <pageno> Integer 페이지번호 RIPIS 오픈서비스는 REST 방식의 UTF-8 문자셋환경을지원합니다. 요청파라메터 <totalcount> Integer 전체검색결과수 <items> <item> 값형식 <applno> 문자열출원번호 문자열 ( 필수 ) 발급받은서비스키값을입력합니다. <seq> Integer 순번 <invntkrnm> 문자열발명자명 searchfield 문자열 ( 필수 ) 조회하고자하는필드명을입력합니다. 출원번호 : APPLNO <invntcnntinm> 문자열발명자국가명 query 문자열 ( 필수 ) 검색어를입력합니다. numofrows Integer 결과 ROW 의개수를지정합니다. (default : 10, 최대 : 100 ) pageno Integer 결과에대한페이지번호를지정합니다.(1 or 2 or 3...) 23 24
6 > IPC 정보 API 구분 항목 응답구조 (XML) 응답엘리먼트값형식 Operation URL 주요제공정보 PatentIpcListRequest http:// www.rndip.or.kr/openapi/rest/patentipclistrequest 출원번호, 순번, IPC 코드, IPC 코드 <response> <header> <resultcode> 문자열 검색결과코드를출력합니다. <resultmsg> 문자열 검색결과메시지를출력합니다. <body> <numofrows> Integer 페이지별건수 <pageno> Integer 페이지번호 RIPIS 오픈서비스는 REST 방식의 UTF-8 문자셋환경을지원합니다. <totalcount> Integer 전체검색결과수 요청파라메터 값형식 <items> <item> <applno> 문자열출원번호 문자열 ( 필수 ) 발급받은서비스키값을입력합니다. <seq> Integer 순번 searchfield 문자열 ( 필수 ) 조회하고자하는필드명을입력합니다. 출원번호 : APPLNO <ipccd> 문자열 IPC 코드 <ipcdesc> 문자열 IPC 코드 query 문자열 ( 필수 ) 검색어를입력합니다. numofrows Integer 결과 ROW 의개수를지정합니다. (default : 10, 최대 : 100 ) pageno Integer 결과에대한페이지번호를지정합니다.(1 or 2 or 3...) 25 26
7 > 상태정보 API 구분 항목 응답엘리먼트값형식 <resultmsg> 문자열검색결과메시지를출력합니다. <body> Operation URL 주요제공정보 PatentStatViewRequest http:// www.rndip.or.kr/openapi/rest/patentstatviewrequest 출원번호, 현재상태, 처리상태, 최종처분코드명, 최종처분일자, 거절이유, 소멸일자, 소멸이유 <item> <applno> 문자열 출원번호 <statgbn> 문자열 현재상태 <statnm> 문자열 처리상태 <lastdspstcdnm> 문자열 최종처분코드명 <lastdspstdt> 문자열 최종처분일자 <RefuseCont> 문자열 거절이유 RIPIS 오픈서비스는 REST 방식의 UTF-8 문자셋환경을지원합니다. <extinctiondt> 문자열소멸일자 요청파라메터 값형식 문자열 ( 필수 ) 발급받은서비스키값을입력합니다. searchfield 문자열 ( 필수 ) 조회하고자하는필드명을입력합니다. 출원번호 : APPLNO query 문자열 ( 필수 ) 검색어를입력합니다. 응답구조 (XML) 응답엘리먼트 값형식 <response> <header> <resultcode> 문자열 검색결과코드를출력합니다. 27 28
8 API 구분 항목 응답엘리먼트값형식 <resultcode> 문자열검색결과코드를출력합니다. <resultmsg> 문자열검색결과메시지를출력합니다. Operation URL 주요제공정보 PatentIndexViewRequest http:// www.rndip.or.kr/openapi/rest/patentindexviewrequest 등록번호, 패밀리특허수, 청구항수, 피인용건수, 해외출원여부, 3 극특허여부, 패밀리특허국가수, 패밀리특허리스트, 패밀리특허, 패밀리특허번호, 패밀리특허국가코드, PQI 지수, PQI 등급 <body> <item> <rgstno> 문자열 등록번호 <fmycnt> Integer 패밀리특허수 <dmndclacnt> 문자열 청구항수 <ncitncnt> 문자열 피인용건수 <fornapplfg> 문자열 해외출원여부 RIPIS 오픈서비스는 REST 방식의 UTF-8 문자셋환경을지원합니다. <pat3fg> 문자열 3 극특허여부 <fmynaticnt> 문자열패밀리특허국가수 요청파라메터 <familyinfo> 패밀리특허리스트 값형식 <family> 패밀리특허 문자열 ( 필수 ) 발급받은서비스키값을입력합니다. <fmyno> 문자열패밀리특허번호 searchfield 문자열 ( 필수 ) 조회하고자하는필드명을입력합니다. 등록번호 : RGSTNO <fmynaticd> 문자열패밀리특허국가코드 <pqi> 문자열 PQI 지수 query 문자열 ( 필수 ) 검색어를입력합니다. <pqics> 문자열 PQI 등급 응답구조 (XML) 응답엘리먼트 값형식 <response> <header> 29 30
9 API 구분 Operation PatentDocViewRequest 항목 URL 주요제공정보 http:// www.rndip.or.kr/openapi/rest/patentdocviewrequest 출원번호, 파일명, 원문 URL RIPIS 오픈서비스는 REST 방식의 UTF-8 문자셋환경을지원합니다. 요청파라메터 값형식 searchfield 문자열 ( 필수 ) 문자열 ( 필수 ) 발급받은서비스키값을입력합니다. 조회하고자하는필드명을입력합니다. 출원번호 : APPLNO query 문자열 ( 필수 ) 검색어를입력합니다. kind 문자열 ( 필수 ) A : 공개공보, B: 공고공보 응답구조 (XML) 응답엘리먼트 값형식 <response> <header> <resultcode> 문자열 검색결과코드를출력합니다. <resultmsg> 문자열 검색결과메시지를출력합니다. <body> <item> <applno> 문자열 출원번호 <docname> Integer 파일명 <path> 문자열 원문 URL 31 32
오픈 제 3 장 OPEN-API JAVA 예제코드 Korea Intellectual Property Strategy Institute
제 3 장 JAVA 예제코드 화면예제 - Java Project 선택 -> Next" 클릭 Ⅰ JAVA 예제코드 언어를이용한 RIPIS오픈서비스활용을위한개발환경 - JDK 1.5 이상 - ECLIPSE IDE 개발환경 - https://hc.apache.org/downloads.cgi 에서 HttpClient 4.3.6 자바라이브러리다운로드 ECLIPS IDE 개발환경구성 예제 - Java Project 명칭입력 - "Finish" 클릭 JDK 1.5 이상설치. - ECLIPSE 설치. - 좌측의화면과같이 Package Explorer" 창에서마우스오른쪽클릭후, "New -> Project" 클릭. - Java 소스폴더및 Output 폴더명확인후, "Finish" 클릭 35 36
예제 Project 아래의 src" 폴더에마우스오른쪽클릭후, New" -> "Class" 선택 import org.apache.http.client.clientprotocolexception; import org.apache.http.client.httpclient; import org.apache.http.client.methods.httpget; import org.apache.http.impl.client.defaulthttpclient public class Openapi { JAVA CODE public static void main(string[] args) { - Java Class 창에서 Package 명입력및 Class 명칭입력. - public static void main(string[] args) 체크박스에체크 - Finish 버튼클릭. String ServiceKey = " 서비스키 "; // 발급된서비스키입력 String surl = "http://www.rndip.or.kr/openapi/rest/pjtlistrequest"; HttpClient client = new DefaultHttpClient(); HttpGet areq = new HttpGet(sUrl + "?servicekey="+ ServiceKey +"&pageno=1&numofrows=10&searchfield=govdnm&query= 산림청 "); HttpResponse ares = null; - 단축키 Alt + Enter" 후, 다운로드받은라이브러리를 Add External JARs" 버튼을이용하여, 좌측화면과같이등록. try { ares = client.execute(areq); } catch (ClientProtocolException e) { e.printstacktrace(); } catch (IOException e) { e.printstacktrace(); } BufferedReader rd = null; 샘플코드 package ripis_openapi; import java.io.bufferedreader; import java.io.ioexception; import java.io.inputstreamreader; import java.io.unsupportedencodingexception; import org.apache.http.httpresponse; JAVA CODE try { rd = new BufferedReader (new InputStreamReader(ares.getEntity().getContent(),"utf-8")); } catch (UnsupportedEncodingException e) { e.printstacktrace(); } catch (IllegalStateException e) { e.printstacktrace(); } catch (IOException e) { e.printstacktrace(); } StringBuffer sb = new StringBuffer(); int read = 0; char b[] = new char[1024]; 37 38
CODE 샘플코드에의한결과데이터 { while ((read = rd.read(b))!= -1){ sb.append(b,0,read); } } catch (IOException e) { e.printstacktrace(); } } } System.out.println(sb.toString()); // 결과 XML 출력 39 40
오픈 제 4 장 OPEN-API 코드정보 Korea Intellectual Property Strategy Institute
제 4 장 코드정보 Ⅰ 코드정보 사용시, XML 형식으로출력되는정보에대한출력상태정보를인지할수 있는코드정보 <resultcode> 를제공하며, 해당코드정보의내용은아래의표와 같습니다. 코드 메시지 비고 필수파라메터가누락 11 servicekey 파라미터가없음 20 유효하지않은 servicekey 40 [ 서비스접근거부 ] 인증된 IP 주소가아닙니다. 41 하루 API 호출 traffic 초과 50 해당 API 에접근권한이없음. 54 오픈 API 서비스내부시스템에러. 60 오픈 API 서비스연결실패. 서비스시스템과부하또는장애로인한서비스연결실패. 0 정상검색결과정보제공 (success) 43