sitemap
한식 콘텐츠목록
고문헌 번역서 단행본 향토음식 풍속서류 종가사찰 연구 성과물 영상자료 시각자료
한식문헌
조선시대 궁중음식 고문헌 조선시대 민간음식 고문헌 근대 한식 문헌 의례음식 문헌
옛 그림 속 한식
옛 그림 속 한식
한식연구 결과물
연변 조선족 전통음식 한식 스토리텔링 역사성 있는 한식당 북한의 전통음식 전통혼례상차림
한식 이야기
한식 원형복원 대중서
한식 아카이브에서는 구축된 한식 관련 DB를 개인, 기관이 자유롭게 이용할 수 있도록 검색 OpenAPI를 제공합니다.
검색 OpenAPI의 이용을 위해 사용자 식별 Key를 발급하고 있습니다. 아래의 신청양식을 작성하시고 사용자 식별 Key를 인증받으신 후,
아래의 사용 안내에 따라 검색 OpenAPI를 사용하시기 바랍니다.
신청시 입력한 사용목적 이외에 OpenAPI사용을 금하며, 식별 Key를 타인에게 양도할 수 없습니다.

OpenAPI는 플랫폼으로서의 “웹” 이라는 특징을 기술적으로 구현한 대표적인 Web 2.0 기술입니다.
하나의 웹 사이트에서 사이트가 가진 기능을 이용할 수 있도록 공개한 프로그래밍 인터페이스를 OpenAPI라고 합니다.
  • 검색 Open API 신청
  • Open API 신청 확인
  • Open API 사용법
검색 Open API 사용 Key 신청 하려면 본인확인을 거쳐야합니다.

본인확인하기 취소
검색 영역별로 별로의 URL을 사용하여야 하며, 결과물 출력은 JSON 포맷입니다.
기본 출력변수는 아래와 같습니다.
출력 변수 설명
count integer 결과물 수
next url 다음 페이지 url
previous url 이전 페이지 url
results array 검색 결과 배열

한식 콘텐츠 목록 검색 API

한시콘텐츠 목록을 검색하여 결과를 JSON 포맷으로 전달하는 API 서비스입니다.
검색 영역을 구축 영역별로 제한하여 질의할 수 있습니다.

요청 주소

http://archive.hansik.org/openapi/contents/

요청 변수

요청변수 설명
q string (필수) 질의어
menu string[foodculture|book|...] 분류별 검색
foodculture - 풍속서류
book - 단행본
oldbook - 고문헌
localfood - 향토음식
templeandheadfamily - 종가사찰
research - 연구성과물
videomaterials - 영상자료
visualmaterials - 시각자료
translatedbook - 번역서
page integer 검색결과 목록 페이지

출력 결과

출력 변수 설명
menu string 분류키
menu_verbose string 분류명
title string 서명
title_ko string 서명(한글)
publisher string 출판사
published_year integer 출판년도
edition string 판본
description string 간략설명
journal string 저널명
location string 소장처
link url 서비스 URL

예제 URL

http://archive.hansik.org/openapi/contents/?apikey=API_KEY&q=농서

한식문헌 검색 API

한식문헌 콘텐츠를 검색하여 결과를 JSON 포맷으로 전달하는 API 서비스입니다.
검색 영역을 구축 시대별로 제한하여 질의할 수 있습니다.

요청 주소

http://archive.hansik.org/openapi/bibliography/

요청 변수

요청변수 설명
q string (필수) 질의어
category string[chosun_royal_book|...] 분류별 검색
chosun_royal_book - 궁중음식 고문헌
chosun_folk_book - 민간음식 고문헌
modern_book - 근대 한식문헌
page integer 검색결과 목록 페이지

출력 결과

출력 변수 설명
category string 분류
title string 서명
title_ko string 서명(한글)
published_year integer 출판년도
published_year_verbose string 상세 출판년도
author string 저자
link url 서비스 URL

예제 URL

http://archive.hansik.org/openapi/bibliography/?apikey=API_KEY&q=갈비탕

북한의 전통음식 검색 API

북한의 전통음식 콘텐츠를 검색하여 결과를 JSON 포맷으로 전달하는 API 서비스입니다.
음식명은 물론 도단위 지역명으로 검색할 수 있습니다.

요청 주소

http://archive.hansik.org/openapi/nkfood/

요청 변수

요청변수 설명
q string (q와 region_name 중 하나는 필수) 질의어
region_name string 지역명. 도 단위명
page integer 검색결과 목록 페이지

출력 결과

출력 변수 설명
title string 음식명
region_name url 시도 단위명
servings integer 인분
year_opening_verbose array::dictionary{title, weight} 요리 재료::재료명과 중량
recipe_directions array::dictionary{sequence, description} 조리법::순번과 설명
link url 서비스 URL

예제 URL

http://archive.hansik.org/openapi/nkfood/?apikey=API_KEY&region_name=평양

오래된 한식당 검색 API

오래된 한식당 콘텐츠를 검색하여 결과를 JSON 포맷으로 전달하는 API 서비스입니다.
식당명과 지역명으로 검색 가능합니다.

요청 주소

http://archive.hansik.org/openapi/sikdang/

요청 변수

요청변수 설명
q string (q와 region_name 중 하나는 필수) 질의어
region_name string 지역명. 도 단위명
page integer 검색결과 목록 페이지

출력 결과

출력 변수 설명
title string 식당명
region_name url 소재지 시도 단위명
year_opening integer 창업년도
year_opening_verbose string 상세 창업년도
sikdang_menu array::dictionary 식당메뉴 목록
address string 식당 주소
map_coord float,float 식당의 좌표(위도,경도)
link url 서비스 URL

예제 URL

http://archive.hansik.org/openapi/sikdang/?apikey=API_KEY&region_name=서울

한식소재 스토리텔링 검색 API

한식소재 스토리텔링 콘텐츠를 검색하여 결과를 JSON 포맷으로 전달하는 API 서비스입니다.

요청 주소

http://archive.hansik.org/openapi/story/

요청 변수

요청변수 설명
q string 질의어
page integer 검색결과 목록 페이지

출력 결과

출력 변수 설명
category string 분류
title string 음식명
link url 서비스 URL

예제 URL

http://archive.hansik.org/openapi/story/?apikey=API_KEY&q=비빔밥




서울특별시 서초구 강남대로 27(양재동 aT센터) 1306호 (재)한식재단 우:137-787 전화) 02-6300-2074 팩스)02-6300-2055
트위터 페이스북 유투브
아카이브 소개 Open API Q&A