Вебхуки (TMS)

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Доступно для

Планы Team, Professional, Business, Enterprise и Software UI/UX

Свяжитесь с отделом продаж по вопросам лицензирования.

Вебхуки — это произвольные URL-адреса, которые обрабатывают HTTP POST-запросы, позволяя отправлять уведомление сторонним системам о заданных событиях.

Phrase отслеживает, был ли успешно получен обратный вызов вебхука. Если получение вебхука не удается 3000 раз, он деактивируется с отправкой уведомление администраторам учетная запись, а сбой отмечается для конкретного вебхука на странице вебхуков. Механизм повторных попыток имеет максимум 10 попыток, при этом интервал между ними рассчитывается до максимального значения в 30 минут.

Вебхуки можно отключать/включать, просматривать их историю, тестировать или удалять на странице вебхуков, выбрав отдельный вебхук для отображения панель инструментов. Функция История предоставляет обзор вызовов за предыдущие 14 дней, а неудачные вебхуки можно повторить.

Важно

Белый список IP-адресов для подключений вебхуков был признан устаревшим и заменен токенами безопасности вебхуков.

Вебхуки можно выбрать для следующих событий:

Job status changed
Задание создано
Job assigned
Срок выполнения задания изменен
Оригинал задания обновлен
Перевод задания обновлен (относится к действию обновить перевод в заданиях)
Продолжающееся задание обновлено
Проект создан
Статус проекта изменен
Срок выполнения проекта изменен
Шаблон проекта создан
Шаблон проекта изменен
Шаблон проекта удален
Shared project assigned
Метаданные проекта обновлены
Предварительный перевод завершен
Анализ создан
Задание удалено
Проект удален
Задание экспортировано
Задание не экспортировано
Импорт Language AI завершен
Перевод Language AI завершен

Настроить вебхуки

Чтобы настроить вебхуки, выполните следующие действия:

Со страницы настроек прокрутите вниз раздел «Интеграции» и нажмите вебхуки.

Откроется страница вебхуков.
Нажмите добавить вебхук или создать.

Откроется страница создать новый вебхук.
Укажите имя, URL-адрес и токен безопасности, если требуется.

Укажите значение, которое будет включено в заголовок x-memsource-токен или заголовок 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": "Admin",
          "lastName": "Admin",
          "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": {
      "Идентификатор": 2
      "uid": "4RvyVbwX00KerkomA7kpT9",
      "lastWorkflowLevel": 1
    },
    "assignedTo": [
      {
        "vendor": {
          "id": 1,
          "name": "Abc",
          "vendorToken": "4-ifos0-CAqPo"
        }
      },
      {
        "linguist": {
          "id": 3,
          "firstName": "Admin",
          "lastName": "Admin",
          "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": "Admin",
           "lastName": "Admin",
           "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": [
    {
      "Идентификатор": 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": {
        "Идентификатор": 12277756,
        "uid": "4RvyVbwX00KerkomA7kpT9
        "lastWorkflowLevel": 1
      },
      "assignedTo": []
    }
  ],
  "event": "JOB_DUE_DATE_CHANGED"
}

Таблица статус

При работе с интерфейс приложений API, вебхуками и пользовательским интерфейсом статус может называться немного иначе.

интерфейс приложений API	Webhook	UI
NEW	NEW	НОВЫЙ
ACCEPTED	ASSIGNED	ПРИНЯТО (поставщиком)
DECLINED	DECLINED_BY_LINGUIST	ОТКЛОНЕНО (поставщиком)
REJECTED	REJECTED_BY_LINGUIST	ОТКЛОНЕНО (поставщиком)
DELIVERED	COMPLETED	СДАНО
EMAILED	EMAILED	ОТПРАВЛЕНО (по поставщику)
COMPLETED	COMPLETED_BY_LINGUIST	ЗАВЕРШЕНО (по поставщикам)
ОТМЕНЕНО	CANCELLED	ОТМЕНЕНО