Webhookok

A webhookok értesítik és segítenek összegyűjteni a Crowdin projektben bekövetkezett legfontosabb eseményeket, például a befejezett fordításokról vagy a lektorálásról. Ezek a felhasználó által definiált visszahívások lehetővé teszik, hogy a Crowdin megnyissa a korábban beállított URL-eket a HTTP-n keresztül.

Csak a projekt tulajdonosai és a projektmenedzserek regisztrálhatnak webhookot.

A webhookokat a következő események figyelésére állíthatja be: a projekt teljesen lefordításra vagy felülvizsgálatra került, fájl teljesen lefordítva vagy felülvizsgálva, fordítás hozzáadva, frissítve, törölve, jóváhagyva vagy jóváhagyása visszavonva.

Áttekintés

Adja meg a következő információkat, hogy létrehozhasson egy webhookot Crowdinban:

  • A webhook neve (például: “App Project Translated”).
  • Az URL, ahová a visszahívást küldeni kell.
  • A kérelem módszere, vagy GET vagy POST, amely jelzi az adott erőforrás számára végrehajtani kívánt műveletet.
  • A tartalom típusa (multipart/form-data, application/json, application/x-www-form-urlencoded csak a POST kérelem módhoz használható).
  • Az URL-be írandó események. Kiválaszthat egy adott eseményt vagy egy meghatározott eseménysorozatot.

Webhookok hozzáadása

A webhookok Crowdinban történő beállításához kövesse az alábbi lépéseket:

  1. Menjen a Projektbeállítások, API fülre.
  2. Görgessen a Webhookok részre, és kattintson a Webhook hozzáadása lehetőségre. webhook hozzáadása
  3. Adja meg a webhook nevét és URL-címét a kérelmek fogadásához.
  4. Válassza ki a megfelelő kérelem módszert GET vagy POST. Ha a POST lehetőséget választja – válasszon egy tartalom típust ehhez a kérelem módhoz.
  5. Válasszon ki egy eseményt vagy eseménysorozatot az értesítések fogadásához.
  6. Kattintson a Teszt elemre, hogy ellenőrizze, milyen hasznos tartalmat kap.
  7. A módosítások mentéséhez kattintson a Hozzáadás gombra. webhook létrehozása

Események

A következő eseményekre állíthatja be a webhookokat:

A fájl teljesen lefordítva

A webhook akkor lép életbe, ha a projektfájlok bármelyike teljesen lefordításra került.

Hasznos tartalom példa:

{
    "event": "file.translated",
    "project": {{project_identifier}},
    "project_id": {{project_id}},
    "language": {{language_code}},
    "file_id": {{file_identifier}},
    "file": {{file_name}}
}

A fájl teljesen felülvizsgálva

A webhook akkor lép életbe, ha a projektfájlok bármelyike teljesen felülvizsgálatra került.

Hasznos tartalom példa:

{
    "event": "file.approved",
    "project": {{project_identifier}},
    "project_id": {{project_id}},
    "language": {{language_code}},
    "file_id": {{file_identifier}},
    "file": {{file_name}}
}

A projekt teljesen lefordítva

A webhook akkor kerül elküldésre, amikor a projekt összes karakterlánca lefordításra került.

Hasznos tartalom példa:

{
    "event": "project.translated",
    "project": {{project_identifier}},
    "project_id": {{project_id}},
    "language": {{language_code}}
}

A projekt teljesen felülvizsgálva

A webhook akkor kerül elküldésre, amikor a projekt összes karakterlánca felülvizsgálatra került.

Hasznos tartalom példa:

{
    "event": "project.approved",
    "project": {{project_identifier}},
    "project_id": {{project_id}},
    "language": {{language_code}}
}

Az exportált fordítás frissítve

A webhook akkor kerül elküldésre, amikor a karakterlánc végleges fordítása frissül.

Hasznos tartalom példa:

{
    "event": "translation.updated",
    "project": {{project_identifier}},
    "project_id": {{project_id}},
    "language": {{language_code}},
    "source_string_id": {{source_string_identifier}},
    "old_translation_id": {{old_translation_identifier}},
    "new_translation_id": {{new_translation_identifier}},
    "user": {{user_name}},
    "user_id" {{user_identifier}},
    "file_id": {{file_identifier}},
    "file": {{file_name}}
}

Javasolt fordítás hozzáadva

A webhook akkor lép életbe, ha a projekt karakterlánca lefordításra került.

Hasznos tartalom példa:

{
    "event": "suggestion.added",
    "project": {{project_identifier}},
    "project_id": {{project_id}},
    "language": {{language_code}},
    "file_id": {{file_identifier}},
    "file": {{file_name}},
    "source_string_id": {{source_string_identifier}},
    "translation_id": {{translation_identifier}},
    "user": {{user_name}},
    "user_id": {{user_identifier}}
}

Javasolt fordítás frissítve

A webhook akkor lép életbe, ha a projekthez tartozó karakterlánc korábban hozzáadott fordítása frissítésre került.

Hasznos tartalom példa:

{
    "event": "suggestion.updated",
    "project": {{project_identifier}},
    "project_id": {{project_id}},
    "language": {{language_code}},
    "file_id": {{file_identifier}},
    "file": {{file_name}},
    "source_string_id": {{source_string_identifier}},
    "translation_id": {{translation_identifier}},
    "user": {{user_name}},
    "user_id": {{user_identifier}}
}

Javasolt fordítás törölve

A webhook akkor lép életbe, ha a projekthez tartozó karakterlánc korábban hozzáadott fordítása törlésre került.

Hasznos tartalom példa:

{
    "event": "suggestion.deleted",
    "project": {{project_identifier}},
    "project_id": {{project_id}},
    "language": {{language_code}},
    "file_id": {{file_identifier}},
    "file": {{file_name}},
    "source_string_id": {{source_string_identifier}},
    "translation_id": {{translation_identifier}},
    "user": {{user_name}},
    "user_id": {{user_identifier}}
}

Javasolt fordítás jóváhagyva

A webhook akkor lép életbe, ha a projekthez tartozó karakterlánc korábban hozzáadott fordítása jóváhagyásra került.

Hasznos tartalom példa:

{
    "event": "suggestion.approved",
    "project": {{project_identifier}},
    "project_id": {{project_id}},
    "language": {{language_code}},
    "file_id": {{file_identifier}},
    "file": {{file_name}},
    "source_string_id": {{source_string_identifier}},
    "translation_id": {{translation_identifier}},
    "user": {{user_name}},
    "user_id": {{user_identifier}}
}

Javasolt fordítás jóváhagyása visszavonva

A webhook akkor lép életbe, ha a projekthez tartozó karakterlánc korábban hozzáadott fordításához a jóváhagyás visszavonásra került.

Hasznos tartalom példa:

{
    "event": "suggestion.disapproved",
    "project": {{project_identifier}},
    "project_id": {{project_id}},
    "language": {{language_code}},
    "file_id": {{file_identifier}},
    "file": {{file_name}},
    "source_string_id": {{source_string_identifier}},
    "translation_id": {{translation_identifier}},
    "user": {{user_name}},
    "user_id": {{user_identifier}}
}

Webhookok szerkesztése vagy törlése

A meglévő webhookok listája a Webhookok részben jelenik meg. A webhookokat közvetlenül a megjelenített listában szerkesztheti vagy törölheti.

webhook szerkesztése törlése

Hívási előzmények

Az összes hozzáadott webhook hívási előzménye ugyanabban a szakaszban lesz elérhető. A szűrővel ellenőrizheti az összes webhook értesítést vagy csak a sikertelen webhook értesítéseket.

hívási előzmények

Hasznos volt ez a cikk?