WEB-Transer＠SDK

翻訳サーバーREST API (Google 互換 API)

本ドキュメントは株式会社クロスランゲージの翻訳サーバーSDKの一部です。ユーザーは、SDKライセンスの制限と条件に準じてのみ本ドキュメントを使用することができます。

はじめに

クロスランゲージ翻訳サーバーは、新たな開発で推奨される効果的なREST APIを備えています。Google翻訳API互換インターフェースは、現存のコードをベースとして持ちながら容易にネイティブREST APIへ移行できない顧客を支援します。互換インターフェースは、Translate v1とv2のREST APIリクエスト両方に提供されています。

クロスランゲージが提供する翻訳APIの機能は以下の通りです。

  • 単一の言語ペアを使用する複数のテキストブロック ("q"パラメータ) の翻訳
  • コールバックおよびコンテキスト
  • テキストおよびHTMLの翻訳

Google互換インターフェースへの全てのリクエストは、ノーマルREST APIと同じリクエスト要件とライセンス要件に従わなければなりません。

言語コード

対応する言語コードは以下の通りです。

en英語frフランス語
ja日本語deドイツ語
ko韓国語esスペイン語
zh-hans中国語　簡体語 (またはzh, zh-cn)itイタリア語
zh-hant中国語　繁体語 (またはzh-tw)ptポルトガル語

Translate v1

Base URL

Translate v1互換APIの標準URLは以下の通りです。

http://SERVER/clsoap/g1/translate

上記標準URLはSSL (https://) リクエストも同様に対応されています。サーバーアドレスおよびライセンス情報に関しては貴社の営業担当者までご確認ください。

引数

Translate v1リクエストで対応する引数は以下の通りです。

【必要な引数】

q この引数は必須であり、少なくとも一度は指定する必要があります。テキストの複数ブロックを翻訳する際に複数回入力されます。
langpair この引数は必須であり、一度だけ指定する必要があります。元言語と目的言語両方が必要で、言語判定機能は未対応となります。対応する言語コードについては上記の言語コード項目をご参照ください。
key HTTP認証もしくはHTTPヘッダーを使用して翻訳サーバーにライセンスキーが提供されない場合、この引数は必須である。詳細については、REST APIガイドのライセンス項目をご参照ください。

【オプション引数】

callback この引数はオプションです。指定する場合は有効なjavascript識別子でなければなりません。
context この引数はオプションです。指定する場合は有効なjavascript識別子でなければなりません。
format この引数はオプションです。指定する場合は"text"もしくは"html"でなければなりません。指定がない場合、デフォルトでテキストとして指定されます。

【無視される引数】

userip この引数はオプションで翻訳サーバーには無視されます。
v この引数はオプションで翻訳サーバーには無視されます。

Translate v2

Base URL

Translate v2互換APIの標準URLは以下の通りです。

http://SERVER/clsoap/g2/translate

上記標準URLは、SSL (https://) リクエストも同様に対応されています。サーバーアドレスおよびライセンス情報に関しては貴社の営業担当者までご確認ください。

引数

Translate v2リクエストで対応する引数は以下の通りです。

【必要な引数】

q この引数は必須であり、少なくとも一度は指定する必要があります。テキストの複数ブロックを翻訳する際に複数回入力されます。
source この引数は必須であり、一度だけ指定する必要があります。対応する言語コードについては上記の言語コード項目をご参照ください。
target この引数は必須であり、一度だけ指定する必要があります。対応する言語コードについては上記の言語コード項目をご参照ください。
key HTTP認証もしくはHTTPヘッダーを使用して翻訳サーバーにライセンスキーが提供されない場合、この引数は必須である。詳細については、REST APIガイドのライセンス項目をご参照ください。

オプションの引数

callback この引数はオプションです。指定する場合は有効なjavascript識別子でなければなりません。
format この引数はオプションです。指定する場合は"text"もしくは"html"でなければなりません。指定されなければ、デフォルトでテキストとして指定されます。

無視される引数

prettyprint この引数はオプションで翻訳サーバーには無視されます。