# 新文本翻译服务

### 接口描述

    本接口提供功能为：游戏或应用内，通过传入文本和需要翻译的目标代码等的参数，使用翻译服务(支持微软、aws翻译、谷歌翻译)，获取目标语言翻译结果。  
    目前微软支持61种语言，aws支持55种语言，谷歌支持59种语言，统一有73种语言

### 接入前准备

    运营发送申请邮件 提供游戏名称、游戏game_id(手游分安卓和ios是否需要申请多套接入参数)、项目大概上线时间、负责人等获取client_id和app_key发送到相应负责人  
    游戏研发获取相应参数后，依照文档对接。


### 接口信息


**接口签名(参数:verify)说明：** 

    先对需要的参数(除verify外)按key升序排序;
    拼作成key1=val1&key2=val2…的格式;
    并在尾部接上双方约定的密钥;
    最后进行md5加密。


**请求地址：** 

    测试地址：https://qatranslator-api.gtarcade.com/translator
    线上地址：https://translator-api.gtarcade.com/translator

  



**请求方式：** 

    POST

**请求参数：** 

| 参数名    | 必选 | 类型   | 说明                                        |
| :-------- | :--- | :----- | ------------------------------------------- |
| text      | 是   | string | 需要翻译的字符串 最长限制2048字符           |
| to        | 是   | string | 需要翻译的目标语言的语言代码                |
| client_id | 是   | string | 每个APP单独向平台申请,同时会供对应的app_key |
| time      | 是   | int    | 当前时间戳（秒级）                          |
| verify    | 是   | string | 加密验证字符串                              |

### 返回数据

- 成功： 

```
{
		     "status":0,
		     "desc":"success",
		     "data":"早上好",
		     "from":"en"
}
```

- 失败：

```
{
              "status": 4,
              "desc":"invalid time"
}
```

1、返回值说明

| status | 错误描述 |
| :----- | :------- |
| 0      | success  |
| 1      | 其他错误 |
| 2      | 参数错误 |

2、目标语言代码

```
{
	"zh-CHT": "Chinese Traditional",
	"zh-CHS": "Chinese Simplified",
	"yue": "Cantonese (Traditional)",
	"yua": "Yucatec Maya",
	"vi": "Vietnamese",
	"ur": "Urdu",
	"uk": "Ukrainian",
	"ty": "Tahitian",
	"tr": "Turkish",
	"to": "Tongan",
	"tlh": "Klingon",
	"th": "Thai",
	"ta": "Tamil",
	"sw": " Kiswahili",
	"sv": "Swedish",
	"sr-Latn": "Serbian (Latin)",
	"sr-Cyrl": "Serbian (Cyrillic)",
	"sm": "Samoan",
	"sl": "Slovenian",
	"sk": "Slovak",
	"ru": "Russian",
	"ro": "Romanian",
	"pt": "Portuguese",
	"pl": "Polish",
	"otq": "Querétaro Otomi",
	"nl": "Dutch",
	"no": "Norwegian",
	"mww": "Hmong Daw",
	"mt": "Maltese",
	"ms": "Malay",
	"mg": "Malagasy",
	"lv": "Latvian",
	"lt": "Lithuanian",
	"ko": "Korean",
	"ja": "Japanese",
	"it": "Italian",
	"id": "Indonesian",
	"hu": "Hungarian",
	"ht": "Haitian Creole",
	"hr": "Croatian",
	"hi": "Hindi",
	"he": "Hebrew",
	"fr": "French",
	"fj": "Fijian",
	"fil": "Filipino",
	"fi": "Finnish",
	"fa": "Persian",
	"et": "Estonian",
	"es": "Spanish",
	"en": "English",
	"el": "Greek",
	"de": "German",
	"da": "Danish",
	"cy": "Welsh",
	"cs": " Czech",
	"ca": "Catalan",
	"bs-Latn": "Bosnian",
	"bn": "Bangla",
	"bg": "Bulgarian",
	"ar": "Arabic",
	"af": "Afrikaans",
	"sq": "Albanian",
	"am": "Amharic",
	"az": "Azerbaijani",
	"ka": "Georgian",
	"ha": "hausa",
	"ps": "pashto",
	"so": "Somali",
	"es-MX": "Spanish (Mexico)",
	"tl": "Tower gallo",
}
```