요청 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);
}
}
}