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é URL adresy, které zpracovávají HTTP POST požadavky a umožňují oznámení systémům třetích stran o specifikovaných událostech.

Phrase sleduje, zda byla úspěšně přijata zpětná vazba webhooku. Pokud příjem webhooku selže 3000krát, je deaktivován a oznámení je zasláno 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, který se počítá až do maximální hodnoty 30 minut.

Webhooky mohou být zakázány/povolené, 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 neúspěšné webhooky mohou být přehrány.

Důležité

Bílé seznamová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:

Stav zakázky změněn
Zakázka vytvořena
Zakázka přiřazena
Termín dodání zakázky změněn
Aktualizace zdroje zakázky
Aktualizace cíle zakázky (odkazuje na akci Aktualizovat cíl na zakázkách)
Průběžná zakázka aktualizována
Projekt vytvořen
Stav projektu změněn
Termín dodání projektu změněn
Šablona projektu vytvořena
Šablona projektu změněna
Šablona projektu odstraněna
Sdílený projekt přiřazen
Metadata projektu aktualizována
Předpřeklad dokončen
Analýza vytvořena
Zakázka odstraněna
Projekt odstraněn
Zakázka exportována
Zakázka neexportována
Language AI import dokončen
Překlad Language AI 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 preferovanou metodu pro autentizaci odesílatele webhooku.
Vyberte události.
Klikněte na Náhled schématu, abyste viděli 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 s názvem 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í reakci 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": "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 nazývat mírně odlišně.

Rest API	Webhook	UI
NOVÝ	NOVÝ	NOVÝ
PŘIJATO	PŘIŘAZENO	PŘIJATO (poskytovatelem)
VRÁCENO	DECLINED_BY_LINGUIST	VRÁCENO (poskytovatelem)
VRÁCENO	REJECTED_BY_LINGUIST	VRÁCENO (poskytovatelem)
DODÁNO	DOKONČENO	DODÁNO
EMAILED	EMAILED	ODESLÁNO E-MAILEM (poskytovatelem)
DOKONČENO	COMPLETED_BY_LINGUIST	DOKONČENO (poskytovatelem)
ZRUŠENO	ZRUŠENO	ZRUŠENO