link한국역사 질의응답 API 개발가이드

한국역사 질의응답 API는 한국역사 지식베이스를 바탕으로 한 지식베이스 기반의 지능형 질의응답을 활용하기 위한 다양한 API를 제공합니다.

link자연어 QA API

자연어 질문을 입력으로 하여 한국역사 지식베이스로부터 적합한 응답을 찾아 제공하는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/qa/kbqa.json
요청 변수(Request Parameters)
요청 변수명 타입 필수 여부 설명
client_key String Y 애플리케이션에서 생성한 Client Key
query String Y 한국역사 관련 자연어 질문
출력 결과 필드(Response Field)
필드 타입 설명
retunParam Integer 결과 코드 (성공:200)
message String 성공여부 메세지
resultList json 질의응답 결과
Sample 결과(JSON)
API 호출 예제

아래 예제는 자연어 QA 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  
		// query  		  : request parameter  
	    String apiURL = "http://developer.alvis.kr/dev/v1/qa/kbqa.json?client_key=366063259a183272b73030cd3bb43c87&query=이순신의생일은";	    
	    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);
	    }
	}    
}

link개체 식별 API

자연어 질문을 입력으로 하여 자연어 질문을 구성하고 있는 개체 식별 결과를 제공하는 API입니다.

요청 URL
get http://developer.alvis.kr/dev/v1/qa/ner.json
요청 변수(Request Parameters)
요청 변수명 타입 필수 여부 설명
client_Key String Y 애플리케이션에서 생성한 Client Key
query String Y 한국역사 관련 자연어 질문
출력 결과 필드(Response Field)
필드 파입 설명
returnParam Integet 결과 코드 (성공:200)
message String 성공여부 메세지
resultList json 개체 식별 결과
Sample 결과(JSON)
API 호출 예제

아래 예제는 개체 식별 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 
		// query  		  : request parameter  
	    String apiURL = "http://developer.alvis.kr/dev/v1/qa/ner.json?client_key=366063259a183272b73030cd3bb43c87&query=이순신의생일은";	    
	    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);
	    }
	}    
}