Webhooks
Webhooks notify und help du collect Informationen about der key Ereignisse dass happen in dein Crowdin Enterprise Projekt, like completed Übersetzungen oder proofreading. After du configure ein webhook, Crowdin Enterprise wird start sending POST oder GET Anfragen mit Daten zu der webhook URL über HTTP.
Du kannst Webhooks hinzufügen, um Integrationen mit Diensten oder deinem Backend aufzubauen. Zum Beispiel:
- Richte einen Webhook ein, um Benachrichtigungen an das von dir verwendete System zu senden.
- Übermittle Informationen an Drittanbieterdienste mit den spezifischen Anforderungen der Anfrage (z. B. HTTP-Methode, Inhaltstyp).
- Erstelle benutzerdefinierte Integrationen mit Crowdin Enterprise.
Du kannst Webhooks für verschiedene Ereignisse konfigurieren, die im Projekt auftreten, z. B. wenn eine Datei übersetzt oder Korrektur gelesen wird oder wenn eine Zeichenfolge hinzugefügt oder aktualisiert wird.
Weitere Informationen zu Webhook-Ereignissen findest du im Crowdin Developer Portal.
Um configure webhooks in Crowdin Enterprise, folge diesen Schritten:
- Öffne dein Projekt und go zu der Tools Tab (für Organisation-level webhooks, Öffne dein Organisation Einstellungen).
- Wähle Webhooks und Klicke Erstelle aus.
Für die Registrierung eines Webhooks musst du die folgenden Informationen angeben:
- der webhook Name (Zum Beispiel, “neu Übersetzung hinzugefügt”).
- Die Ereignisse, die an die URL gesendet werden sollen. Du kannst entweder ein einzelnes Ereignis oder eine bestimmte Gruppe von Ereignissen auswählen.
- Die URL, an die die Webhook-Callbacks als direkte Anfragen gesendet werden. Weiterleitungen werden nicht unterstützt und führen zu einer fehlgeschlagenen Zustellung. Der Endpunkt muss innerhalb von 30 Sekunden eine
2XX-Antwort zurückgeben. - der Anfrage Methode dass indicates der gewünscht Aktion zu sein performed für ein given resource (Verwende either GET oder POST).
- Der Inhaltstyp für die POST-Anfragemethode (
multipart/form-data,application/jsonoderapplication/x-www-form-urlencoded).- Für den Inhaltstyp
application/jsonkannst du Batch-Webhooks auswählen, um mehrere Ereignisse in einer einzigen Anfrage zusammenzufassen.
- Für den Inhaltstyp
Optional kannst du deinem Webhook spezielle Header hinzufügen. Sie können für zusätzliche Sicherheit, als Autorisierungsmethode und für weitere Zwecke verwendet werden. Zum Beispiel, wenn du Füge hinzu headers, dein webhook Endpunkt kann check them zu ensure dass Informationen ist coming von Crowdin Enterprise.
Je nach dein approach zu webhooks management, du könnte need zu Füge hinzu dedicated Crowdin Enterprise IP addresses zu dein firewall zu allow Crowdin Enterprise zu Öffne der pre-konfiguriert webhook URLs.
Weitere Informationen zu IP-Adressen.
jede Ereignis Typ in Crowdin Enterprise hat ein spezifisch Payload Format mit der relevant Ereignis Informationen. Du kannst die Webhook-Payload anpassen, um die Elemente so hinzuzufügen und zu organisieren, wie es dein System benötigt.
zu check der Ereignis’s possible variables, hover over der Info icon in der Payload Bereich’s right upper corner.
Du kannst access der Liste von alle existing webhooks within ein spezifisch Projekt. Du wirst sein able zu Bearbeite oder Lösche webhooks right von der Liste von webhooks angezeigt.
After der Ereignisse sind triggered, du wird sein able zu Prüfung der activity von jede webhook separat. Verwende der Filtere zu Prüfung alle oder nur fehlgeschlagen webhook notifications.
Alternativ, du kann Prüfung der full Liste von sent webhooks in der Tools > Webhook-Protokoll. Filtere webhook notifications von Ergebnis (beliebige oder fehlgeschlagen), Ereignis Typen, oder Name.
Crowdin Enterprise sends jede Ereignis zu dein webhook URL once, so ein Ereignis dass fails isn’t sent again.
Webhooks, die in den letzten 24 Stunden mindestens 100 Mal mit Antwortcodes aus dem Bereich 4xx oder 5xx fehlgeschlagen sind, werden automatisch deaktiviert.
Deaktivierte Webhooks werden im Bereich Webhooks mit einem deaktivierten Häkchen angezeigt. Dies weist darauf hin, dass sie aufgrund anhaltender Fehler derzeit inaktiv sind. Um mehr über fehlgeschlagene Webhooks zu erfahren, gehe zum Bereich Aufrufverlauf > Fehlgeschlagen. Dort kannst du detaillierte Informationen zu den bei jedem fehlgeschlagenen Webhook aufgetretenen Problemen anzeigen.
Nachdem du die Ursache der Webhook-Fehler identifiziert und behoben hast, kannst du die Webhooks manuell reaktivieren, um ihre Funktion wiederherzustellen. Wähle im Bereich Webhooks den deaktivierten Webhook zur Reaktivierung aus.
mit der help von Crowdin Enterprise webhooks, du kann send notifications about pre-konfiguriert Ereignis Typen direkt zu ein spezifisch Slack Kanal.
Um das Senden von Webhooks an Slack zu konfigurieren, musst du eine einfache Slack-App erstellen.
Weitere Informationen zum Senden von Nachrichten an Slack über Incoming Webhooks.
Sobald du Erstelle und configure dein Slack app, du’ll haben ein Webhook URL dass sollte sein used für der Webhooks Konfiguration in Crowdin Enterprise.