机器翻译API简介

机器翻译API，是Tmxmall为了响应用户号召，提供目前通用领域的机器翻译引擎的集成服务。目的是为了降低用户使用机器翻译的成本，只需要注册一个账号，即可使用各种各样的机器翻译服务。除了以上优点，用户可在Tmxmall个人中心完成机器翻译引擎一键切换，省事省心。目前Tmxmall机器翻译API已集成到YiCAT、memoQ 8.6、SDL Trados 2014、2015、2017、2019中。

点击查看代码示例：https://github.com/tmxmall/api-demo/tree/master/mt-api

API接口

引擎选择接口URL

http://api.tmxmall.com/v1/http/setmtprovider?mt_provider=XXXX&mt_field=ecomerce&user_name=XXX&client_id=d0c78b242894a032cb8c3aa7483284b4&de=trados

输入参数:

返回参数:

可选引擎列表和垂直领域:

翻译调用接口URL

http://api.tmxmall.com/v1/http/mttranslate?text=XXXX&user_name=XXX&client_id=d0c78b242894a032cb8c3aa7483284b4&from=zh-CN&to=en-US&de=trados

输入参数:

语言列表：

说明：client_id即为tmxmall的API Key，client_id需要登录到Tmxmall网站个人中心查看。

返回参数:

错误码说明:

返回数据为json格式，示例如下：

{"error_code":"0","error_msg":"成功","from":"zh-CN","to":"en-US","text":"你好","mt_set":[{"src":"你好","tgt":"Hello,","provider":"Baidu"}]}

其他异常情况:

验证接口超时时间为5秒，5秒无信息返回，可认为是Tmxmall网站超时或者是网络超时。

用户ClientId验证接口

机器翻译api集成商在用户设置账号的时候需要验证账号信息是否正确。验证接口如下：

接口URL

http://api.tmxmall.com/v1/http/clientIdVerify?user_name=XXXX&client_id=12334455&de=trados

get请求，无需用户登录

输入参数

说明：client_id即为tmxmall的API Key，client_id需要登录到Tmxmall网站个人中心查看。

返回参数

返回数据为json格式，示例如下：

成功：{"error_code":"0","error_msg":"成功"}

失败：{"error_code":"1","error_msg":"系统异常"}

错误码说明

目前可能出现的错误码：

其他异常情况

验证接口超时时间为5秒，5秒无信息返回，软件可认为是Tmxmall网站超时或者是网络超时。

机器翻译API

机器翻译API有三个接口：API key验证接口、设置机器引擎接口和翻译调用接口，参考代码：https://github.com/tmxmall/api-demo/tree/master/mt-api

/**
* 机器翻译API接入的demo
*
*/
public class MtDemo {
private static Logger logger = Logger.getLogger(MtDemo.class);
public static void main(String[] args) {
//用户ClientId验证接口
String testCidUrl = MtApiUrlConstant.CLIENTID_VERIFY;
testClientId(testCidUrl);
//设置机器引擎接口地址
String setmturl = MtApiUrlConstant.SET_MTPROVIDER;
setMtProvider(setmturl);
//翻译接口地址
String mtTransUrl = MtApiUrlConstant.MT_TRANSLATE;
mtTranslate(mtTransUrl);
}
/**
* 调用用户ClientId验证接口
* @param url
*/
public static void testClientId(String url) {
// params用于存储要请求的参数
Map<String, String> params = new HashMap<String, String>();
//按接口要求传递参数
params.put("user_name", "");
params.put("client_id", "");
params.put("de", "");
String result = urlConnection(url, params);
logger.info("---调用用户ClientId验证接口---"+result);
}
/**
*调用翻译接口
* @param url
*/
public static void mtTranslate(String url) {
//params用于存储要请求的参数
Map<String, String> params = new HashMap<String, String>();
//按接口要求传递参数
params.put("user_name", "");
params.put("client_id", "");
params.put("de", "");
params.put("text", "");
params.put("from", "");
params.put("to", "");
String result = urlConnection(url, params);
logger.info("---调用翻译接口---"+result);
}

/**
* 调用机器引擎接口
* @param url
*/
public static void setMtProvider(String url) {
//params用于存储要请求的参数
Map<String, String> params = new HashMap<String, String>();
// 按接口要求传递参数：用户Tmxmall邮箱账号，用户clientId，调用方，选择的引擎，领域（非必填）
params.put("user_name", "");
params.put("client_id", "");
params.put("de", "");
params.put("mt_provider", "");
params.put("mt_filed", "");
String result = urlConnection(url, params);
logger.info("---调用机器引擎接口---"+result);
}
/**
*主要用于请求地址，并加上请求参数
* @param requestUrl
* @param params
* @return
*/
public static String urlConnection(String requestUrl, Map<String,String> params) {
// buffer用于接受返回的字符
StringBuffer buffer = new StringBuffer();
try {
URL url = new URL(requestUrl + "?" + paramsFilter(params));
//打开http连接
HttpURLConnection httpUrlConn = (HttpURLConnection) url.openConnection();
//传递参数需要开启输入
httpUrlConn.setDoInput(true);
//提交方式
httpUrlConn.setRequestMethod("GET");
httpUrlConn.connect();
InputStream inputStream = httpUrlConn.getInputStream();
InputStreamReader inputStreamReader = new InputStreamReader(inputStream,"utf-8");
//构造一个字符流缓存
BufferedReader bufferedReader = new BufferedReader(inputStreamReader);
//将bufferReader的值给放到buffer里
String str = null;
while ((str = bufferedReader.readLine()) != null) {
buffer.append(str);
}
//关流
bufferedReader.close();
inputStreamReader.close();
inputStream.close();
inputStream = null;
//断开连接
httpUrlConn.disconnect();
}catch (MalformedURLException e) {
e.printStackTrace();
}catch (IOException e) {
e.printStackTrace();
}
return buffer.toString();
}

/**
* 将map里的参数变成像 user_name=###&client_id=###的格式
*
* @param params
* @return
*/
public static String paramsFilter(Map<String,String> params) {

StringBuffer buffer = new StringBuffer();
params.forEach((k, v) -> {
try {
//对参数中的中文进行处理
buffer.append(k).append("=").append(URLEncoder.encode(v+"","UTF-8")).append("&");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
});
return buffer.toString();
}
}

定义接口的url常量

public class MtApiUrlConstant {

private static String[] hosts = new String[]{"http://api.tmxmall.com"}; // 配置请求的host

private static String serverName = hosts[0];

public static final String SET_MTPROVIDER = serverName + "/v1/http/setmtprovider";

public static final String MT_TRANSLATE = serverName + "/v1/http/mttranslate";
public static final String CLIENTID_VERIFY = serverName + "/v1/http/clientIdVerify";
}