翻譯工具 3.0:直譯

將某種語言的文字從某個指令碼轉換成另一個指令碼。

要求 URL

POST 要求傳送至:

https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0

請參閱虛擬網路翻譯工具服務所選取的網路和私人端點組態和支援的支援。

要求參數

在查詢字串上傳遞的要求參數為:

查詢參數 描述
api-version 必要參數。
用戶端要求的 API 版本。 值必須為 3.0
語言 必要參數。
指定要從某個指令碼轉換成另一個指令碼的文字語言。 向服務查詢其支援語言而取得的 transliteration 範圍列出可能的語言。
fromScript 必要參數。
指定輸入文字所使用的指令碼。 使用 transliteration 範圍查閱支援語言,以尋找可用於所選取語言的輸入指令碼。
toScript 必要參數。
指定輸出指令碼。 使用 transliteration 範圍查閱支援的語言,以尋找可用於所選取之輸入語言和輸入指令碼組合的輸出指令碼。

要求標頭包括:

標題 描述
驗證標頭 必要的要求標頭。
請參閱可用的驗證選項
Content-Type 必要的要求標頭。
指定承載的內容類型。 可能的值為:application/json
Content-Length 必要的要求標頭。
要求本文的長度。
X-ClientTraceId 選擇項
用於識別唯一要求的 GUID,由用戶端產生。 若您使用名為 ClientTraceId 的查詢參數在查詢字串中包含追蹤識別碼,您就可以省略此標頭。

要求本文

要求的本文是 JSON 陣列。 每個陣列項目都是字串屬性名為 Text 的 JSON 物件,其代表要轉換的字串。

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

適用下列限制:

  • 陣列最多可以有 10 個項目。
  • 陣列專案的文字值不能超過 1,000 個字元,包括空格。
  • 要求中包含的整個文字不能超過 5,000 個字元,包括空格。

回應本文

成功的回應是輸入陣列的每個字串各有一個結果的 JSON 陣列。 結果物件包含下列屬性:

  • text:將輸入字串轉換成輸出腳本所產生的字串。

  • script:字串,指定在輸出中所使用的指令碼。

範例 JSON 回應如下:

[
    {"text":"konnnichiha","script":"Latn"},
    {"text":"sayounara","script":"Latn"}
]

回應標頭

標題 描述
X-RequestId 服務產生的值,用於識別要求。 作為疑難排解之用。

回應狀態碼

以下是要求傳回的可能 HTTP 狀態碼。

狀態碼 描述
200 成功。
400 其中一個查詢參數遺失或無效。 請先修正要求參數再重試。
401 要求無法驗證。 請確認認證已指定且有效。
403 要求未獲授權。 請查看詳細錯誤訊息。 此程式碼通常表示已使用試用版訂用帳戶提供的所有免費翻譯。
429 伺服器已拒絕要求,因為用戶端已超過要求限制。
500 發生意外錯誤。 若錯誤仍然存在,請回報:失敗的日期和時間、來自回應標頭 X-RequestId 的要求識別碼,以及來自要求標頭 X-ClientTraceId 的用戶端識別碼。
503 暫時無法使用伺服器。 重試要求。 若錯誤仍然存在,請回報:失敗的日期和時間、來自回應標頭 X-RequestId 的要求識別碼,以及來自要求標頭 X-ClientTraceId 的用戶端識別碼。

如果發生錯誤,要求也會傳回 JSON 錯誤回應。 錯誤碼是 6 位數的數字,其中結合了 3 位數的 HTTP 狀態碼,後面接著將錯誤進一步分類的 3 位數數字。 v3 翻譯工具參考頁面上可找到常見的錯誤碼。

範例

下列範例示範如何將兩個日文字串轉換成羅馬拼音的日文。

此範例中要求的 JSON 酬載:

[{"text":"こんにちは","script":"jpan"},{"text":"さようなら","script":"jpan"}]

如果您在不支援 Unicode 字元的命令列視窗中使用 cURL,請採用下列 JSON 承載,並將它儲存到名為 的 request.txt 檔案中。 請務必使用 UTF-8 編碼儲存該檔案。

curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "X-ClientTraceId: 875030C7-5380-40B8-8A03-63DACCF69C11" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d @request.txt