전남광주통합특별시 보성군_한국차박물관 소장자료 정보 데이터 조회 서비스

본 데이터는 전라남도 보성군 한국차박물관이 보유한 다양한 차 관련 유물 및 소장 자료를 실시간으로 조회할 수 있는 오픈 API 서비스이다. 보성군은 유구한 차 문화의 역사적 가치를 보존하고 이를 디지털화하여 학술적, 교육적 활용도를 높이기 위해 소장 유물의 상세 정보를 표준화된 데이터 형식으로 개방하고 있다. 데이터의 주요 응답 항목은 소장품명, 분류명, 재질, 시대적 배경, 용도 및 기능, 유물의 정밀 수치(높이, 너비, 지름 등), 그리고 고해상도 이미지 파일 주소와 유물의 역사적 맥락을 풀이한 상세 설명 등으로 구성되어 있다.제공되는 정보는 고려시대와 조선시대를 거쳐 광복 이후까지 아우르는 금속 및 도자 재질의 주전자, 찻잔, 탕기 받침 등 실물 유물의 입체적인 데이터를 포함한다. 또한 각 유물의 외형을 확인할 수 있는 이미지 경로가 포함되어 있어 디지털 박물관 구축이나 전시 콘텐츠 개발 시 시각 자료로 즉각 활용이 가능하다. 화로탕기 받침이나 유기 주전자와 같이 현대에는 생소한 민속품의 정확한 명칭과 실질적인 쓰임새를 명시하여 문화유산에 대한 접근성을 획기적으로 개선하였다.이 서비스는 박물관 큐레이터, 고미술 연구자, 교육 콘텐츠 개발자 및 일반 관람객들에게 신뢰도 높은 유물 정보를 제공하는 데 그 목적이 있다. 공공데이터 오픈 API 표준 규격을 준수하여 설계되었으며, 사용자는 이를 통해 보성 차 문화의 정수를 보여주는 소장품 정보를 선택적으로 수집하고 분석할 수 있다. 보성군은 본 API를 통해 소장 자원의 투명한 관리 체계를 공개하고 문화 자산의 공유 가치를 실현함으로써 지역 문화 브랜드의 위상을 제고하고자 한다.

body header item items 간직하고 있는 물품의 이름 결과메세지 결과코드 관리하기 위해 부여한 번호 높은 정도 데이터 작성 기준일자 돈이나 물건 혹은 마음 따위를 쓰는 형편 두꺼운 정도 시각적으로 표현하기 위하여 제공된 그래픽 콘텐츠의 이미지 주소 어떤 일이나 대상의 내용을 상대편이 잘 알 수 있도록 밝혀 낱낱이 자세히 말함 여러 갈래로 나누어진 범위나 부분 역사적으로 어떤 표준에 의하여 구분한 일정한 기간. 원이나 구 따위에서 중심을 지나는 직선 위에서 아래로 나 있는 방향 재료가 가지는 성질 전체 결과 수 종류에 따라서 가름하는 것의 이름 페이지번호 평면이나 넓은 물체의 가로로 건너지른 거리 하는 구실이나 작용을 함 한 페이지 결과 수 한끝에서 다른 한끝까지의 거리.

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

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '간직하고 있는 물품의 이름=값' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '데이터 작성 기준일자=20260101' \
  --data-urlencode '응답유형(xml=값' \
  --data-urlencode 'json)=값' \
  --data-urlencode '종류에 따라서 가름하는 것의 이름=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "간직하고 있는 물품의 이름": "값",
  "공공데이터포털에서 받은 인증키": "값",
  "데이터 작성 기준일자": "20260101",
  "응답유형(xml": "값",
  "json)": "값",
  "종류에 따라서 가름하는 것의 이름": "값",
});

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": "발급받은_인증키",
    "간직하고 있는 물품의 이름": "값",
    "공공데이터포털에서 받은 인증키": "값",
    "데이터 작성 기준일자": "20260101",
    "응답유형(xml": "값",
    "json)": "값",
    "종류에 따라서 가름하는 것의 이름": "값",
}

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