webhooky (TMS)

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

K dispozici pro

Plány Team, Professional, Business, Enterprise a Software UI/UX

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

Webhooky jsou libovolné adresy URL, 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á maximálně 10 pokusů, přičemž interval mezi pokusy 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 přehrát znovu.

Důležité

Povolení 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 projekt 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
Language AI import 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 Webhooky.

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 byl změněn

{
"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 stav jmenovat mírně odlišně.

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