규장각한국학 연구원의 통합의궤 데이터를 서비스할 수 있습니다.
통합의궤 API를 사용하기 위해서는 '애플리케이션 등록'을 통해 키를 등록해야 사용할 수 있습니다.
애플리케이션 등록:
등록하기
1 기본정보
1.1 지원하는 타입
- • XML 형태로 서비스를 제공합니다.
- • utf-8 인코딩을 사용합니다.
- • 검색어는 k2hl 태그를 붙여서 제공합니다.
2 서비스 이용
2.1 기본사항
Service API명 |
의궤 통합서비스 |
API 호출 결과 타입 |
XML |
일일사용량 |
5000회 |
호출방법 |
HTTP |
API설명 |
통합의궤자료 정보를 제공합니다. |
2.2 Request URL
URL |
Method |
http://147.46.103.189/api_center.jsp |
GET |
2.3 Request Parameters
이름 |
type |
설명 |
infoType |
String |
a는 기본정보, b는 안내정보, c는 상세정보를 요청한다. |
sWord |
String |
검색하고자 하는 검색어 |
startPos |
String |
시작 |
pageCnt |
String |
한번에 가져올 갯수 |
2.4 Response Fields
결과요소 |
값 |
설명 |
kyu |
element(필수): ksm |
검색 결과물의 xml 최상의 root 요소입니다. |
info/total |
string(필수): |
질의에 대한 전체 검색 결과 수를 나타냅니다. |
info/page |
string(필수): |
현재 페이지 번호를 나타냅니다. |
info/ipp |
string(필수): |
페이지당 표시되는 항목 수를 나타냅니다. |
items/item/a_class |
string(필수): |
기본정보의 형식분류를 나타냅니다. |
items/item/a_cclass |
string(필수): |
기본정보의 내용분류를 나타냅니다. |
items/item/a_jun |
string(필수): |
기본정보의 주제 국가전례를 나타냅니다. |
items/item/a_king |
string(필수): |
기본정보의 주제 왕실문화를 나타냅니다. |
items/item/a_kclass |
string(필수): |
기본정보의 왕대분류를 나타냅니다. |
items/item/a_chung |
string(필수): |
기본정보의 청구기호를 나타냅니다. |
items/item/a_human |
string(필수): |
기본정보의 인물을 나타냅니다. |
items/item/a_group |
string(필수): |
기본정보의 기관단체를 나타냅니다. |
items/item/a_area |
string(필수): |
기본정보의 작성지역을 나타냅니다. |
items/item/a_year |
string(필수): |
기본정보의 작성시기를 나타냅니다. |
items/item/a_size |
string(필수): |
기본정보의 크기를 나타냅니다. |
items/item/a_pan |
string(필수): |
기본정보의 판본을 나타냅니다. |
items/item/a_jang |
string(필수): |
기본정보의 장정을 나타냅니다. |
items/item/a_cnt |
string(필수): |
기본정보의 수량을 나타냅니다. |
items/item/a_pan |
string(필수): |
기본정보의 판식을 나타냅니다. |
items/item/a_jejil |
string(필수): |
기본정보의 재질을 나타냅니다. |
items/item/a_pyo |
string(필수): |
기본정보의 표기문자를 나타냅니다. |
items/item/a_dosul |
string(필수): |
기본정보의 도설을 나타냅니다. |
items/item/a_osojang |
string(필수): |
기본정보의 원소장처를 나타냅니다. |
items/item/a_hsojang |
string(필수): |
기본정보의 현소장처를 나타냅니다. |
items/item/b_pyo |
string(필수): |
안내정보의 표제어를 나타냅니다. |
items/item/b_cont |
string(필수): |
안내정보의 내용을 나타냅니다. |
items/item/b_rela |
string(필수): |
안내정보의 관련문헌을 나타냅니다. |
items/item/b_human |
string(필수): |
안내정보의 집필자를 나타냅니다. |
items/item/c_justice |
string(필수): |
상세정보의 정의를 나타냅니다. |
items/item/c_pyo |
string(필수): |
상세정보의 표제를 나타냅니다. |
items/item/c_neje |
string(필수): |
상세정보의 내제를 나타냅니다. |
items/item/c_pan |
string(필수): |
상세정보의 판심제를 나타냅니다. |
items/item/c_content |
string(필수): |
상세정보의 상세내용을 나타냅니다. |
items/item/c_jugi |
string(필수): |
상세정보의 주기사항를 나타냅니다. |
items/item/c_ref |
string(필수): |
상세정보의 참고문헌을 나타냅니다. |
items/item/c_human |
string(필수): |
상세정보의 집필자를 나타냅니다. |
2.5 Respones Sample Code(헌종을 검색한 경우)