Webhooks (TMS)

Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

K dispozici pro

edice Team, Professional, Business a Enterprise

S dotazy ohledně licencí se obraťte na prodejní oddělení.

Webhooky jsou libovolné URL, které zpracovávají požadavky HTTP POST umožňující oznámení systémů třetích stran o zadaných událostech.

Phrase sleduje, zda bylo úspěšné volání webhooku. Pokud příjem webhooku selže 3000krát, je deaktivován oznámením zaslaným správcům uživatelského účtu a selhání je uvedeno na konkrétním webhooku na stránce webhooků. Mechanismus opakování má maximálně 10 opakování s intervalem mezi opakováními, který se počítá až do maximální hodnoty 30 minut.

Webhooky lze zakázat/povolit, otestovat nebo odstranit ze stránky webhooků najetím na jednotlivé webhooky a kliknutím na pro přístup k nabídce. Funkce Historie poskytuje přehled volání za posledních 14 dní a neúspěšné webhooky lze opakovat.

Důležité

Seznam připojení webhooků pomocí IP adres nebyl platný a byl nahrazen bezpečnostními tokeny webhooků.

Webhooky lze vybrat pro následující události:

Job status changed
Zakázka vytvořena
Job assigned
Termín dodání zakázky změněn
Zdroj zakázky aktualizován
Cíl zakázky aktualizován (Týká se akce Aktualizovat cíl na zakázkách)
Průběžná zakázka aktualizována
Projekt vytvořen
Změna stavu projektu
Termín dodání projektu změněn
Šablona projektu vytvořena
Šablona projektu změněna
Šablona projektu odstraněna
Shared project assigned
Metadata projektu aktualizována
Předpřeklad dokončen
Analýza vytvořena
Zakázka odstraněna
Projekt odstraněn
Zakázka exportována
Nedošlo ke stažení zakázky
Import Jazyka AI dokončen
Překlad prostřednictvím Language AI je dokončen

Konfigurace webhooků

Webhooky nakonfigurujete takto:

Na stránce Nastavení přejděte dolů do oddílu Integrace a klikněte na webhooky.

Otevře se stránka Webhooky.
Klikněte na Přidat webhook.

Otevře se stránka pro vytvoření.
Zadejte URL.
V případě potřeby zadejte bezpečnostní token.

Určete hodnotu, která má být uvedena buď v hlavičce x-Memsource-token, nebo v hlavičce Autorizace, což uživateli umožňuje zvolit preferovanou metodu ověření odesílatele webhooku.
Vyberte události.
Kliknutím na schéma náhledu zobrazíte odpověď webhooku při spuštění.
Klikněte na Vytvořit webhook.

Webhook je přidán do seznamu na stránce Webhooky.

Příklady použití webhooku

Webová stránka s názvem RequestBin poskytne URL, kterou použijete při vytváření webhooku.

Při Další změně stavu zakázky nebo vytvoření zakázky na uživatelském účtu obdrží URL od systému odpovídající odpověď. Skutečné použití může být složitější a příjem odpovědi by měl být považován za signál pro připojenou aplikaci k provádění určitých akcí.

Události

Příklady, kdy se změní stav zakázky, přiřazení zakázky, vytvoření zakázky a kdy se změní termín dodání zakázky.

Stav zakázky se změnil

{
"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": "Správce",
          "lastName": "Správce",
          "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"
}

Zakázka přiřazena

{
"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_ASSIGNED"
}

Vytvořená zakázka

{
 "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"
}

Termín dodání zakázky změněn

{
  "jobParts": [
    {
      "id": 127865777,
      "uid": "ElTXvXnNIHEN2xgL5sU2L2",
      "internalId": "1",
      "task": "LvkAHilgobApeoVm_dc4",
      "fileName": "Bílá kniha EU 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"
}

Tabulka stavu

Při práci s API, webhooky a uživatelským rozhraním se může stav pojmenovat mírně jinak.

Rest API	Webhook	UI
NEW	NEW	NOVÝ
ACCEPTED	ASSIGNED	PŘIJATO (poskytovatelem)
DECLINED	DECLINED_BY_LINGUIST	ODMÍTNUTO (poskytovatelem)
REJECTED	REJECTED_BY_LINGUIST	VRÁCENO (poskytovatelem)
DELIVERED	COMPLETED	DODÁNO
EMAILED	EMAILED	E-MAILEM (podle poskytovatele)
COMPLETED	COMPLETED_BY_LINGUIST	DOKONČENO (poskytovatelem)
CANCELLED	CANCELLED	ZRUŠENO