webhooky (TMS)

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

K dispozici pro

Tarify Team, Professional, Business, Enterprise a Software UI/UX

S dotazy ohledně licencí se obraťte na prodejce.

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

Phrase monitoruje, zda bylo zpětné volání webhooku úspěšně přijato. Pokud příjem webhooku selže 3000krát, je deaktivován s oznámením zaslaným správcům uživatelského účtu a selhání je zaznamenáno u konkrétního webhooku na stránce webhooky. Mechanismus opakování má maximum 10 pokusů, přičemž interval mezi opakováními se vypočítává až do maximální hodnoty 30 minut.

Webhooky lze zakázat/povolit, zobrazit historii, otestovat nebo odstranit ze stránky webhooků výběrem jednotlivého webhooku pro zobrazení panelu nástrojů. Funkce Historie poskytuje přehled volání za předchozích 14 dní a neúspěšné webhooky lze znovu spustit.

Důležité

Whitelistování připojení webhooků pomocí IP adres bylo zastaralé a bylo nahrazeno 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 (Odkazuje na akci aktualizovat cíl u zakázek)
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 Language AI dokončen
Překlad prostřednictvím Language AI je dokončen

Konfigurovat webhooky

Chcete-li konfigurovat webhooky, postupujte podle těchto kroků:

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

Otevře se stránka webhooků.
Klikněte na Přidat webhook nebo Nový.

Otevře se stránka Vytvořit nový webhook.
Zadejte název, URL a v případě potřeby bezpečnostní token.

Zadejte hodnotu, která má být zahrnuta buď v hlavičce x-memsource-token, nebo v hlavičce Authorization, což uživateli umožní vybrat preferovanou metodu ověřování odesílatele webhooku.
Vybrat události.
Kliknutím na Preview schema zobrazíte náhled odpovědi webhooku při spuštění.
Klikněte na Create webhook.

Webhook se přidá do seznamu na stránce Webhooks.

Příklady použití webhooku

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

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

Události

Příklady změny stavu zakázky, přiřazení zakázky, vytvoření zakázky a změny termínu 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": "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"
}

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

Zakázka vytvořena

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

Tabulka stavů

Při práci s API, webhooky a uživatelským rozhraním se může název stavu mírně lišit.

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	DELIVERED
EMAILED	EMAILED	ODESLÁNO E-MAILEM (poskytovatelem)
COMPLETED	COMPLETED_BY_LINGUIST	DOKONČENO (poskytovatelem)
CANCELLED	CANCELLED	ZRUŠENO