Webhooks (TMS)

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

Доступно для

Команда, Профессиональные, Бизнес, Предприятие и Программное обеспечение UI/UX планы

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

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

Фраза отслеживает, был ли успешно получен обратный вызов вебхука. Если прием вебхука не удался 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",
    "задача": "SEfSaenvqFgctE1I0_dc1",
    "fileName": "en.txt",
    "targetLang": "af",
    "workflowLevel": 1,
    "статус": "НОВЫЙ",
    "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": "АДМИНИСТРАТОР",
          "timezone": "Европа/Лондон",
          "active": true,
          "deleted": false,
          "terminologist": false,
          "dateCreated": "2016-10-11T07:43:22Z"
        }
      }
    ]
  }
],
"event": "JOB_STATUS_CHANGED"
}

Задание назначено

{
"jobParts": [
  {
    "id": 9,
    "uid": "ipmdz5p0sagqcOYaijTZU2",
    "internalId": "4",
    "задача": "SEfSaenvqFgctE1I0_dc1",
    "fileName": "en.txt",
    "targetLang": "af",
    "workflowLevel": 1,
    "статус": "НОВЫЙ",
    "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": "АДМИНИСТРАТОР",
          "timezone": "Европа/Лондон",
          "active": true,
          "deleted": false,
          "terminologist": false,
          "dateCreated": "2016-10-11T07:43:22Z"
        }
      }
    ]
  }
],
"event": "JOB_ASSIGNED"
}

Задание создано

{
 "jobParts": [
   {
     "id": 9,
     "uid": "ipmdz5p0sagqcOYaijTZU2",
     "internalId": "4",
     "задача": "SEfSaenvqFgctE1I0_dc1",
     "fileName": "en.txt",
     "targetLang": "af",
     "workflowLevel": 1,
     "статус": "НОВЫЙ",
     "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": "АДМИНИСТРАТОР",
           "timezone": "Европа/Лондон",
           "active": true,
           "deleted": false,
           "terminologist": false,
           "dateCreated": "2016-10-11T07:43:22Z"
         }
       }
     ]
   }
 ],
 "event": "JOB_CREATED"
}

Срок задания изменен

{
  "jobParts": [
    {
      "id": 127865777,
      "uid": "ElTXvXnNIHEN2xgL5sU2L2",
      "internalId": "1",
      "задача": "LvkAHilgobApeoVm_dc4",
      "fileName": "EU White Paper Edited.doc",
      "targetLang": "de",
      "workflowLevel": 1,
      "статус": "НОВЫЙ",
      "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, Webhooks и 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	ОТМЕНЕНО