| [1] 웹서비스(SOAP) |
|
나라기록검색에서 제공하는 검색 기능을 활용하여, 새로운 기록정보 서비스를 만들어 나갈 수 있도록 해주는 서비스로,
|
| WSDL과 SOAP에 기반하고 있습니다.
|
|
|
[2] 제공 기능
|
|
|
|
메타데이터 검색
|
serachMetadata
|
기록정보를 검색합니다.
검색 요청변수와 출력결과 필드는 나라기록검색 Open API를 참조하십시오.
|
 |
|
UCI 검색
|
searchUCI
|
기록정보를 검색합니다.
결과값은 UCI코드만을 포함합니다.
|
 |
|
상세정보 조회
|
getMetadata
|
UCI주소로 기록물에 대한 상세정보를 조회합니다.
|
 |
|
갱신된 기록물 UCI 목록 조회
|
getUpdatedUCI
|
특정일을 기준으로 추가 또는 수정된 기록물의 UCI 코드 목록을 조회합니다.
|
 |
|
갱신된 기록물 상세정보 조회
|
getUpdatedMetadata
|
특정일을 기준으로 추가 또는 수정된 기록물 정보를 조회합니다.
|
 |
|
 |
|
|
|
[3] 이용방법
|
|
웹서비스를 이용하려면 나라기록 Open API에서 사용되는 인증키가 필요합니다.
|
|
인증키 발급은 여기를 참조하십시오.
|
|
웹서비스는 WSDL을 이용하여, 프로그램 소스코드를 자동 생성하고,
|
|
이렇게 생성된 소스코드를 이용하여 서비스 기능을 손쉽게 이용할 수 있습니다.
|
|
대표적인 프로그램 개발도구인 이클립스에서의 웹서비스 이용방법입니다.
|
|
먼저 메뉴에서 File>New>Other… 를 선택하여, Web Service Client 프로젝트를 시작 합니다.
|
|
|
|
Web Services 대화상자가 나타나면 나라기록검색 웹서비스의 WSDL 주소를 입력하고,
|
|
Next 버튼을 클릭합니다. WSDL 주소는 다음과 같습니다.
|
|
http://search.archives.go.kr/services/wsForPublic?wsdl
|
|
|
|
생성된 소스 코드를 저장할 위치를 선택하고 Finish를 선택합니다.
|
|
|
|
작업이 완료되면 아래와 같이 소스코드가 자동으로 생성된 것을 보실 수 있습니다.
|
|
|
|
생성된 소스코드를 이용하여 웹서비스 기능을 이용할 수 있습니다.
|
|
|