Webhooks

Webhooks allow you to receive information about the key events that happen in your Crowdin project, like completed translations or proofreading. Efter opsætning af en projekt-webhook, vil Crowdin begynde at sende POST- eller GET-anmodninger med data til webhook-URL’en via HTTP.

Kun projektejere og -administratorer kan registrere en webhook.

Brugsstudier

Der kan tilføjes webhooks til at opbygge integrationer med tjenesterne eller med en backend. F.eks.:

• Opsæt en webhook for at sende notifikationer til det brugte system.
• Videresend oplysninger til tredjepartstjenester med specifikke forespørgselskrav (f.eks. HTTP-metode, indholdstype).
• Opret tilpassede integrationer med Crowdin.

Events

Webhooks kan opsættes til flg. begivenheder:

• File fully translated – a file is translated into one of the target languages
• File fully reviewed – translations in a file are approved for one of the target languages
• File added
• File updated
• File reverted
• File deleted
• Project fully translated – all files are translated into one of the target languages
• Project fully reviewed – translations in all files are approved for one of the target languages
• Project successfully built
• Exported translation updated – final translation of a string is updated
• Source string added
• Source string updated
• Source string deleted
• Suggested translation added – a string in the project is translated
• Suggested translation updated – a translation for a string in the project is updated
• Suggested translation deleted – one of the translations is deleted
• Suggested translation approved – a translation for a string is approved
• Suggested translation disapproved – approval for a previously added translation is removed
• String comment/issue created
• String comment/issue updated
• String comment/issue deleted
• String comment/issue restored
• Task added
• Task status changed
• Task deleted

Webhook Payload-eksempler

Visit the Webhooks article on Crowdin Developer Portal.

Tilføjelse af Webhooks

To configure webhooks in Crowdin, open your project and go to Tools > Webhooks. Click Add Webhook to start configuring your new webhook.

Flg. oplysninger skal angives for at registrere en webhook:

• The webhook name (for example, “App Project Translated”).
• Begivenhederne, som skal overføres URL’en. Der kan enten vælges en begivenhed eller et bestemt begivenhedssæt.
• URL’en, hvortil callback skal sendes.
• Forespørgselsmetoden, der angiver den ønskede handlingsudførelse for en given ressource (brug enten GET eller POST).
• Indholdstypen for POST-anmodningsmetoden (multipart/form-data, application/json, eller application/x-www-form-urlencoded).
• For applikations-/json-indholdstypen kan vælge sBatch webhooks for at fusionere flere begivenheder til én enkelt forespørgsel.

Optionally, you can add special headers to your webhook. De kan bruges til ekstra sikkerhed som en godkendelsesmetode og meget mere. For example, if you add headers, your webhook endpoint can check them to ensure that information is coming from Crowdin.

When adding a webhook, click Test webhook to see how your application will react to that call.

Depending on your approach to webhook management, you might need to add dedicated Crowdin IP addresses to your firewall to allow Crowdin to open the pre-configured webhook URLs.

Read more about IP Addresses.

Redigere eller Slette Webhooks

Within a specific project, you can access and manage configured webhooks by editing or deleting them directly from the displayed list.

Kaldhistorik

In the Calls History section, you can view the list of calls of all webhooks that were configured in the project. Use the filter to view all or only unsuccessful webhook notifications.

Søge assistance

Behov for hjælp til brug af Webhooks eller evt. spørgsmål? Kontakt Supportteamet.