행정안전부 국가기록원

웹서비스 활용

웹서비스(SOAP)

국가기록원검색에서 제공하는 검색 기능을 활용하여, 새로운 기록정보 서비스를 만들어 나갈 수 있도록 해주는 서비스로, WSDL과 SOAP에 기반하고 있습니다.


제공기능
제공기능 상세정보
명칭 칭기능(operation) 설명
메타데이터 검색 serachMetadata 기록정보를 검색합니다.
검색 요청변수와 출력결과 필드는 국가기록원검색 Open API를 참조하십시오.
상세정보 조회 searchUCI 기록정보를 검색합니다.
getMetadata UCI주소로 기록물에 대한 상세정보를 조회합니다.

이용방법
  • 웹서비스를 이용하려면 나라기록 Open API에서 사용되는 인증키가 필요합니다.
  • 인증키 발급은 여기를 참조하십시오.
  • 웹서비스는 WSDL을 이용하여, 프로그램 소스코드를 자동 생성하고,
  • 이렇게 생성된 소스코드를 이용하여 서비스 기능을 손쉽게 이용할 수 있습니다.
  • 대표적인 프로그램 개발도구인 이클립스에서의 웹서비스 이용방법입니다.
1) 먼저 메뉴에서 File>New>Other… 를 선택하여, Web Service Client 프로젝트를 시작 합니다.
프로젝트를 시작 화면 캡쳐이미지
2) \ Web Services 대화상자가 나타나면 국가기록원검색 웹서비스의 WSDL 주소를 입력하고,
Next 버튼을 클릭합니다. WSDL 주소는 다음과 같습니다.

http://search.archives.go.kr/services/wsForPublic?wsdl

Web Services 대화상자 화면 캡쳐이미지
3) 생성된 소스 코드를 저장할 위치를 선택하고 Finish를 선택합니다.
Finish 선택후 화면 캡쳐이미지
4) 작업이 완료되면 아래와 같이 소스코드가 자동으로 생성된 것을 보실 수 있습니다.
이클립스 작업 화면 캡쳐이미지
5) 생성된 소스코드를 이용하여 웹서비스 기능을 이용할 수 있습니다
 웹서비스 기능 화면 캡쳐이미지