행정안전부 국가기록원_나라기록물정보 서비스_GW

국가기록물에 대해 공개 활용 활성화 등 IT환경의 변화속에서 기존의 복잡하고 비용이 높은 웹서비스 대신 개방형, 경량화 연계 지원으로 국민과 기업이 가치를 창출할 수 있는 전자정부 서비스를 발굴 제공하기 위한 서비스로, 국가기록원에서 관리하는 다양한 기록물의 메타데이터를 RSS(XML) 형식으로 제공하여 외부 시스템이 기록물 정보를 실시간으로 활용할 수 있도록 지원합니다. 기록물 구분, 생산년도, 공개구분, 생산기관, 기록물제공, 철 건 ID, 기록물 상세정보페이지 링크등을 제공합니다. 국가기록포털 검색과 연계되어 기록물 제목, 생산기관, 관리번호 등의 정보를 자동으로 수집할 수 있으며, 기록연구, 공공서비스 연계, 민간 활용 등 다양한 분야에서 활용 가능합니다.

channel item 검색결과 문서의 총 개수를 의미 공개구분값(1:공개 2:부분공개 3:비공개) 국가기록원 오픈 API 검색 결과 기관구분값 기록물 건 ID 기록물 구분 (01:일반기록물 02:시청각기록물 03:대통령기록물 04:총독부기록물 05:정부간행물 06:해외기록물 07:역사기록물 08:행정박물 09:민간기록물 10:영화필름 11:방송프로그램 12:구술기록) 기록물 상세정보페이지 링크 기록물 철 ID 기록물 형태 (1:행정박물(관인류) 2:행정박물(상징기념물) 3:행정박물(사무집기류) 4:행정박물(기타) A:일반문서류 B:도면류 C:사진 필름류 D:녹음 동영상류 E:카드류 F:대장류 G:국무회의록 H:지도 I:대통령전자문서 M:정부간행물 O:일반도서 P:총독부간행물) 기록물구분값(RFILE:철 RITEM:건) 기여자정보 생산기관 생산년도 원문온라인열람서비스(Y:가능 N:불가)

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '검색을 원하는 질의 UTF-8 인코딩입니다=값' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '철건 구분[철:rfile=값' \
  --data-urlencode '건:ritem]=값' \
  --data-urlencode '페이지번호=1' \
  --data-urlencode '한 페이지에 출력될 결과수=1'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "검색을 원하는 질의 UTF-8 인코딩입니다": "값",
  "공공데이터포털에서 받은 인증키": "값",
  "철건 구분[철:rfile": "값",
  "건:ritem]": "값",
  "페이지번호": "1",
  "한 페이지에 출력될 결과수": "1",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "검색을 원하는 질의 UTF-8 인코딩입니다": "값",
    "공공데이터포털에서 받은 인증키": "값",
    "철건 구분[철:rfile": "값",
    "건:ritem]": "값",
    "페이지번호": "1",
    "한 페이지에 출력될 결과수": "1",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())