지식베이스 API는 LOD 형태로 구축된 지식을 LOD와 관련된 전문적인 지식 없이 보다 쉽게 이용할 수 있도록 다양한 기능을 RESTful API 형태로 제공합니다.
한국역사 지식베이스 API는 한국역사 지식베이스에 대한 인물, 단체, 사건, 유물/유적에 대한 정보를 제공하는 API입니다.

국가별 인물 조회 Open API는 국가에 따른 인물의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getPersonOfCountry.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
country String 국가 매개변수, 국가를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
personUri 인물의 고유 URI, 인물이 가지고 있는 고유한 URI
personName 인물 고유 URI의 이름, 인물이 가지고 있는 고유한 URI의 이름
Sample 결과(JSON)

유물유적 조회 Open API는 한국역사 지식베이스에 담긴 모든 유물유적의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getCulturalHeritageList.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
culturalHeritageName 유물유적 고유 URI의 이름, 유물유적이 가지고 있는 고유한 URI의 이름
culturalHeritageUri 유물유적의 고유 URI, 유물유적이 가지고 있는 고유한 URI
Sample 결과(JSON)

국가 조회 Open API는 한국역사 지식베이스에 담긴 모든 국가의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getCountryList.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
countryUri 국가의 고유 URI, 국가가 가지고 있는 고유한 URI
countryName 국가 고유 URI의 이름, 국가가 가지고 있는 고유한 URI의 이름
Sample 결과(JSON)

단체 정보 상세 조회 Open API는 단체가 가지고 있는 고유한 URI 값을 이용하여 해당 단체에 대한 상세 정보를 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getInfoOfOrganization.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
organizationUri String 단체Uri 매개변수, 단체Uri 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
key 해당 URI의 속성, 해당 URI가 가지고 있는 속성
value 해당 URI 속성 값, 해당 URI가 가지고 있는 속성의 값
Sample 결과(JSON)

인물 정보 상세 조회 Open API는 인물이 가지고 있는 고유한 URI 값을 이용하여 해당 인물에 대한 상세 정보를 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getInfoOfPerson.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
personUri String 사람Uri 매개변수, 사람Uri 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
key 해당 URI의 속성, 해당 URI가 가지고 있는 속성
value 해당 URI 속성 값, 해당 URI가 가지고 있는 속성의 값
Sample 결과(JSON)

시대별 단체 조회 Open API는 시대에 따른 단체의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getOrganizationOfEra.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
era String 시대 매개변수, 시대를 지정하기 위한 매개변수
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
organizationUri 단체의 고유 URI, 단체가 가지고 있는 고유한 URI
organizationName 단체 고유 URI의 이름, 단체가 가지고 있는 고유한 URI의 이름
Sample 결과(JSON)

지정기관 조회 Open API는 한국역사 지식베이스에 담긴 모든 지정기관의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getAgenceList.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
agencyUri 지정기관의 고유 URI, 지정기관이 가지고 있는 고유한 URI
agencyName 지정기관 고유 URI의 이름, 지정기관이 가지고 있는 고유한 URI의 이름
Sample 결과(JSON)

사건 조회 Open API는 한국역사 지식베이스에 담긴 모든 사건의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getEventList.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
eventName 사건 고유 URI의 이름, 사건이 가지고 있는 고유한 URI의 이름
eventUri 사건의 고유 URI, 사건이 가지고 있는 고유한 URI
Sample 결과(JSON)

국가별 유물유적 조회 Open API는 국가에 따른 유물유적의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getCulturalHeritageOfCountry.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
country String 국가 매개변수, 국가를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
culturalHeritageName 유물유적 고유 URI의 이름, 유물유적이 가지고 있는 고유한 URI의 이름
culturalHeritageUri 유물유적의 고유 URI, 유물유적이 가지고 있는 고유한 URI
Sample 결과(JSON)

지정기관별 유물유적 조회 Open API는 지정기관에 따른 유물유적의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getCulturalHeritageOfAgence.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
agence String 지정기관 매개변수, 지정기관을 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
culturalHeritageName 유물유적 고유 URI의 이름, 유물유적이 가지고 있는 고유한 URI의 이름
culturalHeritageUri 유물유적의 고유 URI, 유물유적이 가지고 있는 고유한 URI
Sample 결과(JSON)

시대 조회 Open API는 한국역사 지식베이스에 담긴 모든 시대의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getEraList.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
eraName 시대 고유 URI의 이름, 시대가 가지고 있는 고유한 URI의 이름
eraUri 시대의 고유 URI, 시대가 가지고 있는 고유한 URI
Sample 결과(JSON)

시대별 유물유적 조회 Open API는 시대에 따른 유물유적의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getCulturalHeritageOfEra.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
era String 시대 매개변수, 시대를 지정하기 위한 매개변수
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
culturalHeritageName 유물유적 고유 URI의 이름, 유물유적이 가지고 있는 고유한 URI의 이름
culturalHeritageUri 유물유적의 고유 URI, 유물유적이 가지고 있는 고유한 URI
Sample 결과(JSON)

사건 정보 상세 조회 Open API는 사건이 가지고 있는 고유한 URI 값을 이용하여 해당 사건에 대한 상세 정보를 확인할 수 있는 API 입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getInfoOfEvent.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
eventUri String 사건Uri 매개변수, 사건Uri 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
key 해당 URI의 속성, 해당 URI가 가지고 있는 속성
value 해당 URI 속성 값, 해당 URI가 가지고 있는 속성의 값
Sample 결과(JSON)

인물 조회 Open API는 한국역사 지식베이스에 담긴 모든 인물의 고유 URI 목록을 조회할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getPersonList.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
personUri 인물의 고유 URI, 인물이 가지고 있는 고유한 URI
personName 인물 고유 URI의 이름, 인물이 가지고 있는 고유한 URI의 이름
Sample 결과(JSON)

문화재 유형 조회 Open API는 한국역사 지식베이스에 담긴 모든 문화재 유형의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getCulturalHeritageClassificationList.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
classificationValueName 문화재 유형 고유 URI의 이름, 문화재 유형이 가지고 있는 고유한 URI의 이름
classificationValueUri 문화재 유형의 고유 URI, 문화재 유형이 가지고 있는 고유한 URI
Sample 결과(JSON)

시대별 사건 조회 Open API는 시대에 따른 사건의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getEventOfEra.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
era String 시대 매개변수, 시대를 지정하기 위한 매개변수
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
eventName 사건 고유 URI의 이름, 사건이 가지고 있는 고유한 URI의 이름
eventUri 사건의 고유 URI, 사건이 가지고 있는 고유한 URI
Sample 결과(JSON)

국가별 단체 조회 Open API는 국가에 따른 단체의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getOrganizationOfCountry.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
country String 국가 매개변수, 국가를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
organizationUri 단체의 고유 URI, 단체가 가지고 있는 고유한 URI
organizationName 단체 고유 URI의 이름, 단체가 가지고 있는 고유한 URI의 이름
Sample 결과(JSON)

유물유적 정보 상세 조회 Open API는 유물유적이 가지고 있는 고유한 URI 값을 이용하여 해당 유물유적에 대한 상세 정보를 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getInfoOfCulturalHeritage.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
culturalHeritageUri String 유물유적Uri 매개변수, 유물유적Uri 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
key 해당 URI의 속성, 해당 URI가 가지고 있는 속성
value 해당 URI 속성 값, 해당 URI가 가지고 있는 속성의 값
Sample 결과(JSON)

국가별 사건 조회 Open API는 국가에 따른 사건의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getEventOfCountry.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
country String 국가 매개변수, 국가를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
eventName 사건 고유 URI의 이름, 사건이 가지고 있는 고유한 URI의 이름
eventUri 사건의 고유 URI, 사건이 가지고 있는 고유한 URI
Sample 결과(JSON)

시대별 인물 조회 Open API는 시대에 따른 인물의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getPersonOfEra.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
era String 시대 매개변수, 시대를 지정하기 위한 매개변수
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
personUri 인물의 고유 URI, 인물이 가지고 있는 고유한 URI
personName 인물 고유 URI의 이름, 인물이 가지고 있는 고유한 URI의 이름
Sample 결과(JSON)

단체 조회 Open API는 한국역사 지식베이스에 담긴 모든 단체의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getOrganizationList.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
organizationUri 단체의 고유 URI, 단체가 가지고 있는 고유한 URI
organizationName 단체 고유 URI의 이름, 단체가 가지고 있는 고유한 URI의 이름
Sample 결과(JSON)

문화재 유형별 유물유적 조회 Open API는 문화재 유형에 따른 유물유적의 고유 URI 목록을 확인할 수 있는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/lod/getCulturalHeritageOfClassification.json
요청 변수(Request Parameters)
요청 변수명 타입 설명
client_key String 애플리케이션에서 생성한 Client Key
limit String SPARQL limit 매개변수, SPARQL 반환 결과의 개수를 지정하기 위한 매개변수
culturalHeritageOfClassification String 문화재 구분 매개변수, 문화재를 구분하기 위한 매개변수
offset String SPARQL offset 매개변수, SPARQL 결과 반환 시 시작 레코드를 지정하기 위한 매개변수
출력 결과 필드(Response Field)
필드 설명
culturalHeritageName 유물유적 고유 URI의 이름, 유물유적이 가지고 있는 고유한 URI의 이름
culturalHeritageUri 유물유적의 고유 URI, 유물유적이 가지고 있는 고유한 URI
Sample 결과(JSON)

Java 기반의 API 호출 예제입니다. 한국역사 지식베이스 API는 비로그인 방식으로 애플리케이션 등록을 통해 발급받은 Client KeyLOD Method, 요청 변수에 값을 적용하여 호출할 수 있습니다.



아래 예제는 한국역사 지식베이스에 담긴 인물의 고유 URI를 조회할 수 있는 API를 호출하는 예제이며, API 호출 결과를 다양한 서비스 개발에 활용해보세요.

// Java Sample Code
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class APISample {
    public static void main(String[] args) {		    	
		// client_key     : application client key  
		// the other key  : request parameter   
	    String apiURL = "http://developer.alvis.kr/dev/v1/lod/client_key=366063259a183272b73030cd3bb43c87&method=getPersonList&limit=100&offset=0";	    
	    try {        	        	
	        URL url = new URL(apiURL);
	        HttpURLConnection con = (HttpURLConnection)url.openConnection();
	        con.setRequestMethod("GET");
	        
	        int responseCode = con.getResponseCode();
	        BufferedReader br;
	        if(responseCode==200) { // success
	            br = new BufferedReader(new InputStreamReader(con.getInputStream()));
	        } else {  				// fail 
	            br = new BufferedReader(new InputStreamReader(con.getErrorStream()));
	        }
	        String inputLine;
	        StringBuffer response = new StringBuffer();
	        while ((inputLine = br.readLine()) != null) {            	
	            response.append(inputLine);
	        }
	        br.close();
	       	System.out.println(response.toString());
	      
	      } catch (Exception e) {
	        System.out.println("error:"+e);
	    }
	}    
}