Webhooks (TMS)

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

利用可能対象

チーム、プロフェッショナル、ビジネス、エンタープライズ、ソフトウェアUI/UXプラン

ライセンスに関する質問は、営業担当までお問い合わせください。

ウェブフックは、指定されたイベントについて3rdパーティシステムに通知するHTTP POSTリクエストを処理する任意のURLです。

フレーズは、ウェブフックコールバックが正常に受信されたかどうかを監視します。ウェブフックの受信が3000回失敗した場合、アカウントの管理者に通知が送信され、特定のウェブフックの失敗がウェブフックページに記録されて無効化されます。再試行メカニズムは最大10回の再試行があり、再試行間の間隔は最大30分まで計算されます。

ウェブフックは無効化/有効化でき、履歴を表示したり、テストしたり、ウェブフックページから個々のウェブフックを選択してツールバーを表示することで削除できます。履歴機能は、過去14日間の呼び出しの概要を提供し、失敗したウェブフックを再生できます。

重要

IPアドレスによるウェブフック接続のホワイトリスト化は廃止され、ウェブフックセキュリティトークンに置き換えられました。

ウェブフックは次のイベントに対して選択できます：

Job status changed
ジョブが作成されました
Job assigned
ジョブの納期が変更されました
ジョブの原文が更新されました
ジョブターゲットが更新されました（ターゲットを更新アクションに関連しますジョブ）
継続ジョブを更新しました
プロジェクトが作成されました
プロジェクトステータスが変更されました
プロジェクトの納期が変更されました
プロジェクトテンプレートが作成されました
プロジェクトテンプレートが変更されました
プロジェクトテンプレートが削除されました
Shared project assigned
プロジェクトのメタデータを更新しました
一括翻訳が完成しました
解析が作成されました
ジョブが削除されました
プロジェクトが削除されました
ジョブがエクスポートされました
ジョブはエクスポートされませんでした
Language AIインポートが完了しました
Language AI翻訳が完了しました

ウェブフックを設定する

ウェブフックを設定するには、次の手順に従ってください：

設定ページから、統合機能セクションまでスクロールし、ウェブフックをクリックします。

ウェブフックページが開きます。
ウェブフックを追加または新規をクリックします。

新しいウェブフックを作成ページが開きます。
名前、URL、および必要に応じてセキュリティトークンを提供してください。

x-memsource-token ヘッダーまたは Authorization ヘッダーに含める値を指定します。これにより、ユーザーはウェブフック送信者の認証方法を選択できます。
イベントを選択します。
実行時のウェブフック応答を表示するには、プレビュースキーマをクリックします。
ウェブフックを作成をクリックします。

ウェブフックはウェブフックページの一覧に追加されます。

ウェブフック使用例

RequestBin というウェブサイトが、ウェブフックを作成する際に使用するURLを提供します。

次回ジョブステータスが変更されるか、アカウント内でジョブが作成されると、URLはシステムから適切な応答を受け取ります。実際の使用はより複雑になる可能性があり、応答の受信は接続されたアプリケーションが特定のアクションを実行するための信号と見なされるべきです。

イベント

ジョブステータスの変更、ジョブの割り当て、ジョブの作成、ジョブの期限が変更されたときの例。

ジョブステータスが変更されました

{
"jobParts": [
  {
    "id":9,
    "uid": "ipmdz5p0sagqcOYaijTZU2",
    "internalId":"4",
    "task":"SEfSaenvqFgctE1I0_dc1",
    "fileName": "en.txt",
    "targetLang": "af",
    "workflowLevel":1,
    "status":"NEW",
    "wordsCount":2,
    "beginIndex":0,
    "endIndex":1,
    "isParentJobSplit": false,
    "dateDue": null,
    "dateCreated":"2016-11-02T17:06:54Z",
    "project": {
      "id":2,
      "uid":"4RvyVbwX00KerkomA7kpT9",
      "lastWorkflowLevel":1
    },
    "assignedTo": [
      {
        "vendor": {
          "id":1,
          "name":"Abc",
          "vendorToken":"4-ifos0-CAqPo"
        }
      },
      {
        "linguist": {
          "id":3,
          "firstName":"管理者",
          "lastName":"管理者",
          "userName": "admin",
          "email": "admin@example.com",
          "role":"ADMIN",
          "timezone":"Europe/London",
          "active": true,
          "deleted": false,
          "terminologist": false,
          "dateCreated":"2016-10-11T07:43:22Z"
        }
      }
    ]
  }
],
"event":"JOB_STATUS_CHANGED"
}

割り当て済のジョブ

{
"jobParts": [
  {
    "id":9,
    "uid": "ipmdz5p0sagqcOYaijTZU2",
    "internalId":"4",
    "task":"SEfSaenvqFgctE1I0_dc1",
    "fileName": "en.txt",
    "targetLang": "af",
    "workflowLevel":1,
    "status":"NEW",
    "wordsCount":2,
    "beginIndex":0,
    "endIndex":1,
    "isParentJobSplit": false,
    "dateDue": null,
    "dateCreated":"2016-11-02T17:06:54Z",
    "project": {
      "id":2
      "uid":"4RvyVbwX00KerkomA7kpT9",
      "lastWorkflowLevel":1
    },
    "assignedTo": [
      {
        "vendor": {
          "id":1,
          "name":"Abc",
          "vendorToken":"4-ifos0-CAqPo"
        }
      },
      {
        "linguist": {
          "id":3,
          "firstName":"管理者",
          "lastName":"管理者",
          "userName": "admin",
          "email": "admin@example.com",
          "role":"ADMIN",
          "timezone":"Europe/London",
          "active": true,
          "deleted": false,
          "terminologist": false,
          "dateCreated":"2016-10-11T07:43:22Z"
        }
      }
    ]
  }
],
"event":"JOB_ASSIGNED"
}

ジョブ作成

{
 "jobParts": [
   {
     "id":9,
     "uid": "ipmdz5p0sagqcOYaijTZU2",
     "internalId":"4",
     "task":"SEfSaenvqFgctE1I0_dc1",
     "fileName": "en.txt",
     "targetLang": "af",
     "workflowLevel":1,
     "status":"NEW",
     "wordsCount":2,
     "beginIndex":0,
     "endIndex":1,
     "isParentJobSplit": false,
     "dateDue": null,
     "dateCreated":"2016-11-02T17:06:54Z",
     "project": {
       "id":2,
       "uid":"4RvyVbwX00KerkomA7kpT9",
       "lastWorkflowLevel":1
     },
     "assignedTo": [
       {
         "vendor": {
           "id":1,
           "name":"Abc",
           "vendorToken":"4-ifos0-CAqPo"
         }
       },
       {
         "linguist": {
           "id":3,
           "firstName":"管理者",
           "lastName":"管理者",
           "userName": "admin",
           "email": "admin@example.com",
           "role":"ADMIN",
           "timezone":"Europe/London",
           "active": true,
           "deleted": false,
           "terminologist": false,
           "dateCreated":"2016-10-11T07:43:22Z"
         }
       }
     ]
   }
 ],
 "event":"JOB_CREATED"
}

ジョブ期限日変更

{
  "jobParts": [
    {
      "id":127865777,
      "uid":"ElTXvXnNIHEN2xgL5sU2L2",
      "internalId":"1",
      "task":"LvkAHilgobApeoVm_dc4",
      "fileName":"EU White Paper Edited.doc",
      "targetLang": "de",
      "workflowLevel":1,
      "status":"NEW",
      "wordsCount":204,
      "beginIndex":0,
      "endIndex":16,
      "isParentJobSplit": false,
      "dateDue":"2018-09-11T22:00:00Z",
      "dateCreated":"2018-09-10T06:25:41Z",
      "project": {
        "id":12277756,
        "uid":"4RvyVbwX00KerkomA7kpT9
        "lastWorkflowLevel":1
      },
      "assignedTo": []
    }
  ],
  "event":"JOB_DUE_DATE_CHANGED"
}

ステータステーブル

API、Webhook、およびUIを使用する際、ステータスの名前がわずかに異なる場合があります。

REST API	Webhook	UI
NEW	NEW	新規
ACCEPTED	ASSIGNED	受け入れられた（プロバイダによって）
DECLINED	DECLINED_BY_LINGUIST	拒否された（プロバイダによって）
REJECTED	REJECTED_BY_LINGUIST	却下された（プロバイダによって）
DELIVERED	COMPLETED	納品済
EMAILED	EMAILED	メール送信済み（プロバイダによって）
COMPLETED	COMPLETED_BY_LINGUIST	完了（プロバイダによって）
CANCELLED	CANCELLED	CANCELLED