APIの使用 (TMS)

これは、単純なAPIシナリオであり、サンプルAPI呼び出しと、APIのみを使用して単純なアクションを完了するためのそれらを連結する方法に関する手順が含まれています。API経由で設定できるオプションは広範囲にわたります。利用可能なすべてのオプションの詳細については、REST APIドキュメントの各セクションを参照してください。

Postman<1> APIプラットフォームを使用してシナリオを作成しました。

これらの例では、標準のリクエストURLはhttps://cloud.memsource.comで始まります。米国のデータセンターにある組織がAPIを使用する場合、リクエストURLはhttps://us.cloud.memsource.comで始まる必要があります。

シナリオ

手法

個々のREST API呼び出しには、適切なメソッドがリストされています。誤ったメソッドを使用すると（例：プロジェクト作成呼び出しでPOSTの代わりにGETを使用）、API呼び出しは失敗します。

ステップ 1: 認証

認証方法には2種類あります。

このシナリオでは、Authentication API呼び出しが使用されます。生成されたトークンは、以降のすべてのAPI呼び出しに必要であり、例のパラメータには記載されていません。

必要なパラメータを使用して認証を行うには、Login APIを使用してください。この場合、usernameとpasswordが必要です。

複数のTMS組織のメンバーは、複数のアカウントに対して同じユーザー名とパスワードを使用します。この場合、ユーザーがログインしたい組織を指定するために、userUidをリクエストボディに追加する必要があります。指定がない場合、ユーザーは指定されたユーザー名とパスワードに関連付けられたデフォルトのアカウントにログインします。

ステップ 2: プロジェクト作成、インポート、および割り当て

プロジェクト作成

プロジェクト API呼び出しを使用して、必須パラメータである name、sourceLang、および targetLangs を指定してプロジェクトを作成します。

前回の呼び出しで取得したプロジェクトUIDを使用して、プロジェクトテンプレート作成 API呼び出しでプロジェクトテンプレートを作成することが可能です。

プロジェクトを作成する最も効率的な方法は、プロジェクトテンプレートを使用することです。前回の呼び出しで取得したプロジェクトテンプレートUIDを使用して テンプレートからプロジェクトを作成 を実行し、プロジェクトテンプレートの設定に基づいて新しいプロジェクトを作成します。

{templateUid} という式は、取得したプロジェクトテンプレートUIDが挿入されるリクエストURL内のプレースホルダーとして機能します。 

ジョブ作成

前回の呼び出しで取得したプロジェクトUIDを使用して、ジョブ作成により、新しく作成されたプロジェクトに直接新しいジョブを追加できます。

{projectUid} という式は、取得したプロジェクトUIDが挿入されるリクエストURL内のプレースホルダーとして機能します。ジョブ作成 API呼び出しでは、リクエストの ヘッダー を、Phraseで要求されるものと一致するように変更する必要があります（他の呼び出しでは、Postmanが自動的に適切なヘッダーをリクエストに追加します）。

すべてのインポートパラメータを、カスタム Memsource ヘッダーに挿入する必要があります。

インポートリクエストを正しく処理するために、Content-Disposition ヘッダーには、定義済みのファイル形式でファイル名を含める必要があります。

原文ファイルをインポートするには、本文に移動し、バイナリ を選択すると、ファイルを選択 オプションが表示されます。

非同期リクエストを取得とジョブ作成の呼び出しからのAsyncRequest UIDを使用して、ジョブが正常に作成され、機能していることを確認します。

返されるジョブUIDは、プロジェクトの各ワークフローステップで一意です。したがって、ワークフローを持つプロジェクトでジョブが作成される場合、レスポンスは各ワークフローステップに対して一意のジョブUIDを返します。 

再利用可能なインポート設定は、インポート設定を作成の呼び出しで構成できます。ジョブ作成の呼び出しで使用できるインポート設定UIDがレスポンスで受信されます。

ジョブにプロバイダを割り当てるには（ジョブ作成の呼び出しで直接割り当てない場合）、ジョブを編集の呼び出しを使用します。

呼び出しに挿入されるプロバイダのIDは、次の2つの方法で取得できます。

割り当てられたユーザーに通知

ジョブUIDは、割り当てられたユーザーに通知呼び出しのオプションパラメータとして、使用するメールテンプレートのIDを表すemailTemplateパラメータと共に使用できます。これは List email templates コールを使用して取得できます。

これは、Phrase UIが使用されているかのように、翻訳者が自分のプロファイルで仕事を開始する場所です。ジョブが完了すると、担当のPMに注意が届き、シナリオの次の部分が開始されます。コールバックは webhooks を介してインターセプトし、シナリオの次の部分を自動的に開始できますが、これについてはこの例では扱いません。

ステップ 3: 訳文ファイル（完了）のダウンロード、プロジェクトを完了に設定

訳文ファイルをダウンロード

このシナリオは、翻訳者が自分の割り当てを完了（ジョブを Completed とマーク）することを前提としていますが、完了したファイルはいつでもダウンロードでき、ジョブが Completed ステータスである必要はありません。 

訳文ファイルをダウンロードするには、Download target file (async)  と Download target file based on async request の2つのAPIコールが必要です。

最初のステップは、projectUid および jobUid パラメータを指定して Download target file (async) を呼び出すことです。複数のワークフローステップを持つプロジェクトから訳文ファイルをダウンロードする場合は、ダウンロードしたい特定のワークフローステップ（例：校正ワークフローステップ）の jobUid を必ず使用してください。

ダウンロード 訳文ファイル（非同期）呼び出しは、翻訳を含む訳文ファイルを生成およびダウンロードするための非同期リクエストを開始します。これはレスポンス内で直接訳文ファイルを提供するのではなく、後続の呼び出しに必要なasyncRequestIdを提供します。 

非同期リクエストを取得をレスポンスのasyncRequestIDと共に使用して、リクエストが完了したことを確認します。非同期リクエストが完了したら、非同期リクエストに基づいて訳文ファイルをダウンロード呼び出しを使用して訳文ファイルをダウンロードできます。asyncRequestIdは一度しか使用できません。ダウンロードが開始されると、asyncRequestIdはそれ以降の使用に対して無効になります。

プロジェクトを完了に設定

プロジェクト内のジョブが完了した後にプロジェクトを確定するには、編集 プロジェクト ステータス呼び出しを使用し、必須パラメータであるprojectUidとstatusを指定して、プロジェクト全体のステータスを完了に変更します。この変更は手動で行われますが、プロジェクト ステータス 自動化が使用されている場合は、ステータスは自動的に変更されます。ウェブフックを待機し、受信したコールバックに基づいて他のアクションを開始することも可能です。