Webhooks (TMS)

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

K dispozici pro

Tým, Profesionální, Obchodní, Podnik a plány UI/UX softwaru

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

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

Phrase sleduje, zda byl callback webhooku úspěšně přijat. Pokud příjem webhooku selže 3000krát, je deaktivován s oznámením zaslaným administrátorům účtu a selhání je zaznamenáno na konkrétním webhooku na stránce Webhooky. Mechanismus opakování má maximálně 10 pokusů s intervalem mezi pokusy vypočítaným až do maximální hodnoty 30 minut.

Webhooky mohou být zakázány/umožněny, zobrazit historii, testovány nebo smazány ze stránky webhooků výběrem jednotlivého webhooku pro zobrazení panelu nástrojů. Funkce Historie poskytuje přehled o voláních za posledních 14 dní a selhané webhooky mohou být znovu přehrány.

Důležité

Whitelistování připojení webhooků podle IP adres bylo zrušeno a bylo nahrazeno bezpečnostními tokeny webhooků.

Webhooky mohou být vybrány 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 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
Language AI import dokončen
Překlad prostřednictvím Language AI je dokončen

Nastavit webhooky

Pro nastavení webhooků 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 bezpečnostní token, pokud je to nutné.

Uveďte hodnotu, která má být zahrnuta buď do hlavičky x-memsource-token nebo do hlavičky Authorization, což umožňuje uživateli zvolit si preferovanou metodu pro autentizaci odesílatele webhooku.
Vyberte události.
Klikněte na Náhled schématu, abyste zobrazili odpověď webhooku při spuštění.
Klikněte na Vytvořit webhook.

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

Příklady použití webhooku

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

Příště, když dojde ke změně stavu zakázky nebo když je v účtu vytvořena zakázka, URL obdrží odpovídající odpověď ze systému. 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, aby provedla určité akce.

Události

Příklady změny stavu zakázky, přiřazení zakázky, vytvoření zakázky a když je změněn termí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": "NOVÝ",
    "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": "Evropa/Londýn",
          "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": "NOVÝ",
    "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": "Evropa/Londýn",
          "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": "NOVÝ",
     "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": "Evropa/Londýn",
           "active": true,
           "deleted": false,
           "terminologist": false,
           "dateCreated": "2016-10-11T07:43:22Z"
         }
       }
     ]
   }
 ],
 "event": "JOB_CREATED"
}

Datum splatnosti zakázky změněno

{
  "jobParts": [
    {
      "id": 127865777,
      "uid": "ElTXvXnNIHEN2xgL5sU2L2",
      "internalId": "1",
      "task": "LvkAHilgobApeoVm_dc4",
      "fileName": "EU White Paper Edited.doc",
      "targetLang": "de",
      "workflowLevel": 1,
      "status": "NOVÝ",
      "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 může být stav pojmenován 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 (poskytovatelem)
COMPLETED	COMPLETED_BY_LINGUIST	DOKONČENO (poskytovatelem)
CANCELLED	CANCELLED	ZRUŠENO