Open API 이용안내

HOME > 이용안내 > Open API 이용안내

기호유학 고문선 Open API 이용방법

1.요청 URL (request url)

  • 고문헌 정보 검색 : http://giho.cnu.ac.kr/api/literature/search.do
  • 고문헌 상세정보 조회 : http://giho.cnu.ac.kr/api/literature/detail.do
  • 인물 정보 검색 : http://giho.cnu.ac.kr/api/person/search.do
  • 인물 상세정보 조회 : http://giho.cnu.ac.kr/api/person/detail.do

2.요청 변수 (request parameter)

  • 고문헌/인물 정보 검색
    고문헌/인물 정보 검색
    요청변수 값 설명
    type string 고문헌 유형을 지정합니다. (인물 정보 검색 시에는 변수로 포함하지 않습니다.)
    • OB : 기호유학 고서 (육서심원 포함)
    • OD : 기호유학 고문서 (금석문 포함)
    target string 검색 항목을 지정합니다.
    • 기호유학 고문헌 정보 검색 시
      • all : 전체(고문헌 명칭, 저자명, 해제)
      • title : 고문헌 명칭
      • creator : 저자명
      • abstract : 해제
    • 기호유학 인물 정보 검색 시
      • person_nm : 인물명
      • person_ho : 인물의 호
      • person_info : 인물설명
    keyword string 검색을 원하는 질의어를 입력합니다. (UTF-8 인코딩)
    page integer 검색결과 목록 중 원하는 페이지를 지정합니다.
    pageSize integer 페이지 당 출력 건수를 지정합니다.
  • 고문헌/인물 상세정보 조회
    고문헌/인물 상세정보
    요청변수 값 설명
    type string 고문헌 유형을 지정합니다. (인물 상세정보 조회 시에는 변수로 포함하지 않습니다.)
    • OB : 기호유학 고서 (육서심원 포함)
    • OD : 기호유학 고문서 (금석문 포함)
    id string 조회 대상 자료의 식별자를 입력합니다.
    • 기호유학 고문헌 상세정보 조회 시 : 고문헌 검색 결과 필드 중 identifier의 값
    • 기호유학 인물 상세정보 조회 시 : 인물 검색 결과 필드 중 personId의 값

3.샘플 URL

4.출력 결과 필드(response field)

  • 고문헌 정보 검색
    하늘색 : 검색정보 회색 : 검색결과
    사업의 성과
    필드 값 설명
    total integer 검색 결과 총 건수 입니다.
    type string 검색 시 지정한 고문헌 유형 입니다.
    target string 검색 시 지정한 검색 항목 입니다.
    keyword string 검색 시 입력한 질의어 입니다.
    page integer 검색결과 목록 중 조회된 페이지 입니다.
    pageSize integer 페이지 당 출력 건수 입니다.
    identifier string 검색된 고문헌의 식별자 입니다.
    dataType string 검색된 고문헌의 고문헌 유형 입니다. (OD:고서, OD:고문서, RC:금석문)
    dataTypeNm string 검색된 고문헌의 고문헌 유형명 입니다.
    mainTitle string 검색된 고문헌의 한글명칭 입니다.
    alternativeTitle string 검색된 고문헌의 한자명칭 입니다.
    mainCreator string 검색된 고문헌의 저자명 입니다.
    created integer 검색된 고문헌의 생성년도(서기) 입니다. (미상인 경우 0)
    relationDate string 검색된 고문헌의 생성년도(간지) 입니다.
    recomFg string 검색된 고문헌의 추천여부 입니다. (Y/N)
    classFullNm string 검색된 고문헌의 분류체계명 입니다.
    uci string 검색된 고문헌의 UCI Code 입니다.
    url string 검색된 고문헌의 상세정보 조회 URL 입니다.
    abstract string 검색된 고문헌의 해제 입니다.
  • 고문헌 상세정보 조회
    하늘색 : 조회정보 회색 : 공통정보 오렌지색 : 고서 파란색 : 고문서 녹색 : 금석문
    사업의 성과
    필드 값 설명
    type string 조회 시 지정한 고문헌 유형 입니다.
    id string 조회 시 지정한 고문헌 식별자 입니다.
    identifier string 조회된 고문헌의 식별자 입니다.
    dataType string 조회된 고문헌의 고문헌 유형 입니다. (OB:고서, OD:고문서, RC:금석문)
    dataTypeNm string 조회된 고문헌의 고문헌 유형명 입니다.
    mainTitle string 조회된 고문헌의 한글명칭 입니다.
    alternativeTitle string 조회된 고문헌의 한자명칭 입니다.
    mainCreator string 조회된 고문헌의 저자 입니다.
    creatorHo string 조회된 고문헌 저자의 호 입니다.
    created integer 조회된 고문헌의 생성년도(서기) 입니다. (미상인 경우 0)
    relationDate string 조회된 고문헌의 생성년도(간지) 입니다.
    recomFg string 조회된 고문헌의 추천여부 입니다. (Y/N)
    uci string 조회된 고문헌의 UCI Code 입니다.
    abstract string 조회된 고문헌의 해제 입니다.
    typeFullNm string 조회된 고서의 형태분류명 입니다.
    classFullNm string 조회된 고서의 분류체계명 입니다.
    banguak string 조회된 고서의 반곽 입니다.
    amountInfo string 조회된 고서의 수량정보 입니다.
    pansimje string 조회된 고서의 판심제 입니다.
    jangjungTypeNm string 조회된 고서의 장정형태 입니다.
    publishPlace string 조회된 고서의 간행처 입니다.
    paperQuality string 조회된 고서의 종이재질 입니다.
    guanggakNm string 조회된 고서의 광각 입니다.
    gyeseonNm string 조회된 고서의 계선 입니다.
    hangjasu string 조회된 고서의 행자수 입니다.
    eomi string 조회된 고서의 어미 입니다.
    condition string 조회된 고서의 상태정보 입니다.
    classFullNm string 조회된 고문서의 분류체계명 입니다.
    receivePerson string 조회된 고문서의 수취자 입니다.
    receiveHo string 조회된 고문서 수취자의 호 입니다.
    amount string 조회된 고문서의 수량정보 입니다.
    envelopeNm string 조회된 고문서의 피봉 입니다.
    jangjungTypeNm string 조회된 고문서의 장정형태 입니다.
    condition string 조회된 고문서의 상태정보 입니다.
    classFullNm string 조회된 금석문의 분류체계명 입니다.
    daesangPerson string 조회된 금석문의 대상 입니다.
    daesangHo string 조회된 금석문 대상의 호 입니다.
    seoPerson string 조회된 금석문의 서 입니다.
    seoHo string 조회된 금석문 서의 호 입니다.
    jeonPerson string 조회된 금석문의 전 입니다.
    jeonHo string 조회된 금석문 전의 호 입니다.
    amount string 조회된 금석문의 수량정보 입니다.
    jeonaek string 조회된 금석문의 전액 입니다.
    address string 조회된 금석문의 주소 입니다.
    coordinates string 조회된 금석문의 좌표값 입니다.
    rubDate string 조회된 금석문의 탁본일자 입니다.
    rubMethodNm string 조회된 금석문의 탁본방법 입니다.
    stoneQualityNm string 조회된 금석문의 석질 입니다.
    chaetakja string 조회된 금석문의 채탁자 입니다.
    condition string 조회된 금석문의 상태정보 입니다.
  • 인물 정보 검색
    하늘색 : 검색정보 회색 : 검색결과
    사업의 성과
    필드 값 설명
    total integer 검색 결과 총 건수 입니다.
    target string 검색 시 지정한 검색 항목 입니다.
    keyword string 검색 시 입력한 질의어 입니다.
    page integer 검색결과 목록 중 조회된 페이지 입니다.
    pageSize integer 페이지 당 출력 건수 입니다.
    personId string 검색된 인물정보의 식별자 입니다.
    personNm string 검색된 인물명 입니다.
    personHo string 검색된 인물의 호 입니다.
    birthYear integer 검색된 인물의 생년 입니다. (미상인 경우 0)
    deathYear integer 검색된 인물의 몰년 입니다. (미상인 경우 0)
    period string 검색된 인물의 시대 입니다.
    recomFg string 검색된 인물의 추천여부 입니다. (Y/N)
    url string 검색된 인물의 상세정보 조회 URL 입니다.
    personInfo string 검색된 인물에 대한 설명 입니다.
  • 인물 상세정보 조회
    하늘색 : 조회정보 회색 : 조회결과
    사업의 성과
    필드 값 설명
    id string 조회 시 지정한 인물정보 식별자 입니다.
    personId string 조회된 인물정보의 식별자 입니다.
    personNm string 조회된 인물명 입니다.
    personHo string 조회된 인물의 호 입니다.
    personSiho string 조회된 인물의 시호 입니다.
    birthYear integer 조회된 인물의 생년 입니다. (미상인 경우 0)
    deathYear integer 조회된 인물의 몰년 입니다. (미상인 경우 0)
    period string 조회된 인물의 시대 입니다.
    hometown string 조회된 인물의 본관 입니다.
    recomFg string 조회된 인물의 추천여부 입니다. (Y/N)
    personInfo string 조회된 인물에 대한 설명 입니다.