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