鍵.png)
使用這些基本 REST API 最佳實踐構(gòu)建出色的 API
登入以后進入API應(yīng)用頁面復(fù)制API密鑰
接入方式
基于HTTP協(xié)議的URL請求
請求地址
http(s)://api.niutrans.com/NiuTransServer/translation
請求方式
GET/POST
請求參數(shù)
| 字段名 | 類型 | 描述 |
|---|---|---|
| from | String | 源語言：待翻譯文本語種參數(shù)?支持語言列表 |
| to | String | 目標(biāo)語言：翻譯目標(biāo)語種參數(shù)?支持語言列表 |
| apikey | String | API密鑰?可在控制臺查看 |
| src_text | String | 待翻譯字符串 該字段必須為UTF-8編碼 |
| dictNo | String | 設(shè)置術(shù)語詞典子庫ID，缺省值為空 |
| memoryNo | String | 設(shè)置翻譯記憶子庫ID，缺省值為空 |
注意事項
1.翻譯文本（src_text字段）必須為UTF-8編碼。
2.在發(fā)送HTTP請求之前需要對src_text字段參數(shù)進行URL Encode。
3.如果請求字符串長度大于1500，請使用POST方式提交請求。
4.Content-Type ：僅支持【application/json】、【application/x-www-form-urlencoded】。
5.dictNo 與 memoryNo 為空時，則使用控制臺中用戶設(shè)置的默認庫。
返回類型
JSON
返回值json格式，會根據(jù)傳遞參數(shù)、任務(wù)處理返回不同的字段，具體字段說明如下：
| 字段名 | 描述 |
|---|---|
| from | 語言語種 |
| to | 語言語種 |
| apikey | API密鑰 |
| src_text | 待翻譯字符串 |
| tgt_text | 翻譯結(jié)果字符串 |
| error_code | 錯誤代碼 |
| error_msg | 錯誤信息 |
請求
curl -d "from=zh&to=en&apikey=您的apikey&src_text=你好" http://api.niutrans.com/NiuTransServer/translation響應(yīng)
{
from: "zh",
to: "en",
tgt_text: "Hello"
}Q：如何找到小牛翻譯 API開放平臺
A：冪簡集成是國內(nèi)領(lǐng)先的API集成管理平臺，專注于為開發(fā)者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API：通過關(guān)鍵詞搜索API(例如，輸入’小牛翻譯 API開放平臺‘這類品類詞，更容易找到結(jié)果)、或者從API hub分類頁進入尋找。
Q：如何測試API接口？
A：
1）首先需要您登錄小牛控制臺，進入或<個人中心>頁獲取APIKEY后，返回前臺頁，按照您需要測試的接口文檔填寫測試內(nèi)容及APIKEY，即可開始測試。
2）或者進入或<個人中心>頁獲取APIKEY后，也可以放入自己代碼進行測試。
API字符統(tǒng)計是對用戶傳遞進來的待翻譯字符串（src_text）參數(shù)，通過Java語言的String.length()計算結(jié)果。（注：包含標(biāo)點符號、空格、換行符等）
示例：
src_text=你好！
統(tǒng)計值:3個字符。
src_text=Hello!
統(tǒng)計值:6個字符。
Q：什么是URLencode?
A：URLencode是一個函數(shù)，可將字符串以URL編碼，用于編碼處理。URL編碼(URL encoding)，也稱作百分號編碼(Percent-encoding)，是特定上下文的統(tǒng)一資源定位符 (URL)的編碼機制。
Q：為什么進行URLencode？
A：當(dāng)字符串?dāng)?shù)據(jù)以url的形式傳遞給web服務(wù)器時，字符串中是不允許出現(xiàn)空格和特殊字符的，需要通過URLencode將需要翻譯的文本做URL編碼才能發(fā)送HTTP請求。大部分編程語言都已有可用的URLencode函數(shù)，具體使用方法可以根據(jù)您使用的編程語言自行搜索。
Q：如何在一次請求中翻譯多個單詞或者多段文本？
A：您可以在發(fā)送的字段【src_text】中用換行符（在多數(shù)編程語言中為轉(zhuǎn)義符號 ）來分隔要翻譯的多個單詞或者多段文本，這樣即可得到多個獨立的翻譯結(jié)果。注意在發(fā)送請求前需對【src_text】字段做URL encode！
除了小牛翻譯 API開放平臺，還有其他替代服務(wù)商也提供類似api服務(wù)，例如：
Lingvanex API開放平臺、doctranslate API開放平臺、百度翻譯開放平臺
更多競品可以在冪簡集成開放平臺中找到。
Q：小牛翻譯 API開放平臺這個密鑰還適用于哪些api？
本文全面而細致地介紹了獲取小牛翻譯API開放平臺密鑰的完整流程，為開發(fā)者們提供了一份條理清晰、易于操作的指南。從平臺賬號的注冊，到開發(fā)者身份驗證的順利完成，再到最終成功獲取API密鑰，每一步操作都配以詳盡的說明與指導(dǎo)，確保開發(fā)者能夠輕松、準(zhǔn)確地完成整個流程。本文還特別強調(diào)了進行可用性測試的重要性。通過測試，開發(fā)者可以驗證小牛翻譯API的集成效果，確保其在實際應(yīng)用中能夠發(fā)揮最佳性能，這對于提升應(yīng)用的翻譯質(zhì)量和用戶體驗至關(guān)重要。本文為開發(fā)者們提供了一個全面、詳盡且極具實用價值的操作指南，不僅幫助他們順利獲取了小牛翻譯API開放平臺的密鑰，還指導(dǎo)他們?nèi)绾斡行У貙⑦@一強大的翻譯功能集成到應(yīng)用中。我們相信，隨著開發(fā)者們對這一指南的深入理解和實踐，將能夠充分利用小牛翻譯API的優(yōu)勢，推動應(yīng)用向更加國際化、智能化的方向發(fā)展，為用戶帶來更加便捷、高效的翻譯服務(wù)體驗。