<?php
$openApiURL = "http://aiopen.etri.re.kr:8000/WiseWWN/WordRel";
$accessKey = "YOUR_ACCESS_KEY";
$firstWord = "FIRST_WORD";
$firstSenseId = "FIRST_SENSE_ID";
$secondWord = "SECOND_WORD";
$secondSenseId = "SECOND_SECSE_ID ";
 
 
$request = array(
    "argument" => array (
        "first_word" => $firstWord,
        "first_sense_id" => $firstSenseId,
        "second_word" => $secondWord,
        "second_sense_id" => $secondSenseId
    )
);
 
try {
    $server_output = "";
    $ch = curl_init();
    $header = array(
        "Content-Type:application/json; charset=UTF-8",
        "Authorization":{$accessKey}
    );
    curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    curl_setopt($ch, CURLOPT_URL, $openApiURL);
    curl_setopt($ch, CURLOPT_VERBOSE, true);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode ( $request) );
 
    $server_output = curl_exec ($ch);
    if($server_output === false) {
        echo "Error Number:".curl_errno($ch)."\n";
        echo "Error String:".curl_error($ch)."\n";
    }
 
    curl_close ($ch);
} catch ( Exception $e ) {
    echo $e->getMessage ();
}
 
echo "result = " . var_dump($server_output);
?>

JSON parsing을 위해 jsoncpp 라이브러리를 사용하여 제공하고 있습니다. jsoncpp 라이브러리에 대한 자세한 설명은 https://github.com/open-source-parsers/jsoncpp 에서 확인 하실 수 있습니다.

HTTP 통신을 위해 curl 라이브러리를 사용하여 제공하고 있습니다. curl 라이브러리에 대한 자세한 설명은 https://curl.haxx.se/libcurl 에서 확인 하실 수 있습니다.

컴파일을 위해서는 아래와 같이 추가된 LIB에 대한 옵션을 추가해야 합니다.

g++ (c++파일명) (JSONCPP)/json/json.h (JSONCPP)/json/json-forwards.h (JSONCPP)/jsoncpp.cpp -I(CURL)/include -lcurl

#include <curl/curl.h>
#include <json/json.h>
#include <iostream>
#include <string>
 
using namespace std;
 
size_t writeDataFunc(void *ptr, size_t size, size_t nmemb, std::string stream);
 
int main() {
    char* openApiURL = (char*)"http://aiopen.etri.re.kr:8000/WiseWWN/WordRel";
    string accessKey = "YOUR_ACCESS_KEY";
    string firstWord = "FIRST_WORD";
    string firstSenseId = "FIRST_SENSE_ID";
    string secondWord = "SECOND_WORD";
    string secondSenseId = "SECOND_SENSE_ID";
 
    Json::Value request;
    Json::Value argument;
 
    argument["first_word"] = firstWord;
    argument["first_sense_id"] = firstSenseId;
    argument["second_word"] = secondWord;
    argument["second_sense_id"] = secondSenseId;
  
    request["argument"] = argument;
 
    CURL *curl;
    curl_slist* responseHeaders = NULL;
    curl = curl_easy_init();
 
    if( curl == NULL ) {
        cout << "Unable to initialize cURL interface" << endl ;
    } else {
        responseHeaders = curl_slist_append( responseHeaders , "Content-Type: application/json; charset=UTF-8" ) ;
        responseHeaders = curl_slist_append( responseHeaders , ("Authorization: " + accessKey).c_str() ) ; 
        string requestJson = request.toStyledString();
        long statusCode;
        string response;
 
        curl_easy_setopt(curl, CURLOPT_URL, openApiURL);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, responseHeaders ) ;
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 5);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, requestJson.c_str());
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writeDataFunc);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
 
        curl_easy_perform(curl);
 
        curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &statusCode);
        curl_easy_cleanup(curl);
 
        cout << "[responseCode] " << statusCode << endl;
        cout << "[responBody]" << endl;
        cout << response << endl;
    }
 
    return 0;
}
 
size_t writeDataFunc(void *ptr, size_t size, size_t nmemb, std::string stream) {
    size_t realsize = size * nmemb;
    std::string temp(static_cast<const char*>(ptr), realsize);
    stream.append(temp);
    return realsize;
}

python 3.0을 기준으로 작성되었습니다.

HTTP 통신을 위해 urllib3 라이브러리를 사용하여 제공하고 있습니다. Python 3.0 이하의 버전에서 예제를 실행하기 위해서는 별도로 urllib3의 설치가 필요합니다. 설치에 대한 설명은 https://pypi.python.org/pypi/urllib3 를 참고하시기 바랍니다. urllib3 라이브러리에 대한 자세한 설명은 https://urllib3.readthedocs.io/en/latest/ 에서 확인 하실 수 있습니다.

#-*- coding:utf-8 -*-
import urllib3
import json
 
openApiURL = "http://aiopen.etri.re.kr:8000/WiseWWN/WordRel"
accessKey = "YOUR_ACCESS_KEY"
firstWord = 'FIRST_WORD'
firstSenseId = 'FIRST_SENSE_ID'
secondWord = 'SECOND_WORD'
secondSenseId = 'SECOND_SENSE_ID'
 
requestJson = {   
    "argument": {
        'first_word': firstWord,
        'first_sense_id': firstSenseId,
        'second_word': secondWord,
        'second_sense_id': secondSenseId
    }
}
 
http = urllib3.PoolManager()
response = http.request(
    "POST",
    openApiURL,
    headers={"Content-Type": "application/json; charset=UTF-8", "Authorization": accessKey},
    body=json.dumps(requestJson)
)
 
print("[responseCode] " + str(response.status))
print("[responBody]")
print(str(response.data,"utf-8"))

var openApiURL = 'http://aiopen.etri.re.kr:8000/WiseWWN/WordRel';
var access_key = 'YOUR_ACCESS_KEY';
var firstWord = 'FIRST_WORD';
var firstSenseId = 'FIRSR_SENSE_ID';
var secondWord = 'SECOND_WORD';
var secondSenseId = 'SECOND_SENSE_ID';
 
var requestJson = {
    'argument': {
        'first_word': firstWord,
        'first_sense_id': firstSenseId,
        'second_word': secondWord,
        'second_sense_id': secondSenseId
    }
};
 
var request = require('request');
var options = {
    url: openApiURL,
    body: JSON.stringify(requestJson),
    headers: {'Content-Type':'application/json','Authorization':access_key}
};
request.post(options, function (error, response, body) {
    console.log('responseCode = ' + response.statusCode);
    console.log('responseBody = ' + body);
});

어휘 간 유사도 분석 API는 요청된 어휘 간 유사도 분석 결과를 JSON 형태의 Text 데이터로 반환합니다.
다음은 정상적인 요청 처리에 대한 HTTP 응답 예입니다.

[HTTP Response Header]
Access-Control-Allow-Origin:*
Connection:close
Content-Length:0
Content-Type:application/json; charset=UTF-8

[HTTP Response Body]
{
    "request_id": "reserved field",
    "result": 0,
    "return_type": "com.google.gson.internal.LinkedTreeMap",
    "return_object": {어휘 간 유사도 분석 결과 JSON}
}

다음은 오류가 발생한 요청 처리에 대한 HTTP 응답 예입니다.

[HTTP Response Header]
Access-Control-Allow-Origin:*
Connection:close
Content-Length:0
Content-Type:application/json; charset=UTF-8

[HTTP Response Body]
{
    "request_id": "reserved field",
    "result": -1,
    "reason": {오류 메시지}
}

분석된 결과는 다음과 같은 내용이 포함되어 있습니다.

어휘 간 유사도 분석 API의 오류 코드 목록은 다음과 같습니다.