Webhooks

Webhooks meddeler og hjælper dig med at indsamle oplysninger om de vigtigste begivenheder, som sker i dit Crowdin-projekt, såsom færdiggjort oversættelse eller korrekturlæsning. After you configure a webhook for the project, Crowdin will start sending POST or GET requests with data to the webhook URL via HTTP.

Only owners and project managers can register a 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).
  • Create custom integrations with Crowdin.

Events

Webhooks kan opsættes til flg. begivenheder:

  • File fuldt oversat

  • Fil er fuldt revideret

  • Fil tilføjet

  • Fil opdateret

  • Fil reverteret

  • Fil slettet

  • Projekt fuldt oversat – alle filer er oversat til et af målsprogene

  • Project fully reviewed – translations in all files for one of the target languages are approved

  • Eksporteret oversættelse opdateret – endelig oversættelse af en streng er opdateret

  • Kildestreng tilføjet

  • Kildestreng opdateret

  • Kildestreng slettet

  • Oversættelsesforslag tilføjet – en streng i projektet er oversat

  • Oversættelsesforslag opdateret – en oversættelse til en projektstreng er opdateret

  • Oversættelsesforslag slettet – en oversættelse er slettet

  • Oversættelsesforslag godkendt – en strengsoversættelse er godkendt

  • Oversættelsesforslagsgodkendelse afvist – godkendelse af en tidligere tilføjet oversættelse er fjernet

  • Opgave tilføjet

  • Opgavestatus ændret

  • Opgave slettet

Webhook Payload-eksempler

  • File fuldt oversat
{
  "events": [
    {
      "event": "file.translated",
      "project": "impact",
      "project_id": "778899",
      "language": "uk",
      "file_id": "1",
      "file": "eksempel.txt"
    }
  ] }
  • Fil er fuldt revideret
{
  "events": [
    {
      "event": "file.approved",
      "project": "impact",
      "project_id": "778899",
      "language": "uk",
      "file_id": "1",
      "file": "eksempel.txt"
    }
  ] }
  • Fil tilføjet
{
  "events": [
    {
      "event": "file.added",
      "project": "impact",
      "project_id": "778899",
      "file_id": "1",
      "file": "eksempel.txt",
      "user_id": "1",
      "user": "hans_hansen",
      "revision": "1"
    }
  ] }
  • Fil opdateret
{
  "events": [
    {
      "event": "file.updated",
      "project": "impact",
      "project_id": "778899",
      "file_id": "1",
      "file": "eksempel.txt",
      "user_id": "1",
      "user": "hans_hansen",
      "revision": "1"
    }
  ] }
  • Fil reverteret
{
    "events": [
        {
            "event": "file.reverted",
            "project": "impact",
            "project_id": "778899",
            "file_id": "1",
            "file": "eksempel.txt",
            "user_id": "1",
            "user": "hans_hansen",
            "revision": "1"
        }
    ] }
  • Fil slettet
{
    "events": [
        {
            "event": "file.deleted",
            "project": "impact",
            "project_id": "778899",
            "file_id": "1",
            "file": "eksempel.txt",
            "user_id": "1",
            "user": "hans_hansen"
        }
    ] }
  • Projekt er fuldt oversat
{
    "events": [
        {
            "event": "project.translated",
            "project": "impact",
            "project_id": "778899",
            "language": "uk"
        }
    ] }
  • Projekt fuldt revideret
{
    "events": [
        {
            "event": "project.approved",
            "project": "impact",
            "project_id": "778899",
            "language": "uk"
        }
    ] }
  • Eksporteret oversættelse opdateret
{
    "events": [
        {
            "event": "translation.updated",
            "project": "impact",
            "project_id": "778899",
            "language": "uk",
            "source_string_id": "1",
            "old_translation_id": "1",
            "new_translation_id": "1",
            "user": "hans_hansen",
            "user_id": "1",
            "file_id": "1",
            "file": "eksempel.txt"
        }
    ] }
  • Kildestreng tilføjet
{
    "events": [
        {
            "event": "string.added",
            "project": "impact",
            "project_id": "778899",
            "string_id": "1",
            "user": "hans_hansen",
            "user_id": "1",
            "file_id": "1",
            "file": "eksempel.txt"
        }
    ] }
  • Kildestreng opdateret
{
    "events": [
        {
            "event": "string.updated",
            "project": "impact",
            "project_id": "778899",
            "string_id": "1",
            "user": "hans_hansen",
            "user_id": "1",
            "file_id": "1",
            "file": "eksempel.txt"
        }
    ] }
  • Kildestreng slettet
{
    "events": [
        {
            "event": "string.deleted",
            "project": "impact",
            "project_id": "778899",
            "string_id": "1",
            "user": "hans_hansen",
            "user_id": "1",
            "file_id": "1",
            "file": "eksempel.txt"
        }
    ] }
  • Oversættelsesforslag tilføjet
{
    "events": [
        {
            "event": "suggestion.added",
            "project": "impact",
            "project_id": "778899",
            "language": "uk",
            "source_string_id": "1",
            "translation_id": "1",
            "user": "hans_hansen",
            "user_id": "1",
            "file_id": "1",
            "file": "eksempel.txt"
        }
    ] }
  • Oversættelsesforslag opdateret
{
    "events": [
        {
            "event": "suggestion.updated",
            "project": "impact",
            "project_id": "778899",
            "language": "uk",
            "source_string_id": "1",
            "translation_id": "1",
            "user": "hans_hansen",
            "user_id": "1",
            "file_id": "1",
            "file": "eksempel.txt"
        }
    ] }
  • Oversættelsesforslag slettet
{
    "events": [
        {
            "event": "suggestion.deleted",
            "project": "impact",
            "project_id": "778899",
            "language": "uk",
            "source_string_id": "1",
            "translation_id": "1",
            "user": "hans_hansen",
            "user_id": "1",
            "file_id": "1",
            "file": "eksempel.txt"
        }
    ] }
  • Oversættelsesforslag godkendt
{
    "events": [
        {
            "event": "suggestion.approved",
            "project": "impact",
            "project_id": "778899",
            "language": "uk",
            "source_string_id": "1",
            "translation_id": "1",
            "user": "hans_hansen",
            "user_id": "1",
            "file_id": "1",
            "file": "eksempel.txt"
        }
    ] }
  • Oversættelsesforslagsgodkendelse afvist
{
    "events": [
        {
            "event": "suggestion.disapproved",
            "project": "impact",
            "project_id": "778899",
            "language": "uk",
            "source_string_id": "1",
            "translation_id": "1",
            "user": "hans_hansen",
            "user_id": "1",
            "file_id": "1",
            "file": "eksempel.txt"
        }
    ] }
  • Opgave tilføjet
{ "events": [
        { "event": "task.added", "project": "impact", "project_id": "778899", "language": "uk", "task_id": "", "user": "hans_hansen", "user_id": "1" } ] }
  • Opgavestatus ændret
{ "events": [
        { "event": "task.statusChanged", "project": "impact", "project_id": "778899", "language": "uk", "task_id": "", "old_status": "", "new_status": "", "user": "hans_hansen", "user_id": "1" } ] }
  • Opgave slettet
{ "events": [
        { "event": "task.deleted", "project": "impact", "project_id": "778899", "language": "uk", "task_id": "", "user": "hans_hansen", "user_id": "1" } ] }

Tilføjelse af Webhooks

To configure webhooks in Crowdin, open your project and go to Integrations > 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”).
  • 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.
  • Begivenhederne, som skal overføres URL’en. Der kan enten vælges en begivenhed eller et bestemt begivenhedssæt.

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

Tilføj Webhook

Depending on your approach to webhooks 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

Man kan tilgå listen over alle eksisterende webhooks i et bestemt projekt. Webhooks kan redigeres eller slette direkte fra den viste liste.

Webhooks-håndtering

Kaldhistorik

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

calls history

Søge assistance

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

Var denne artikel nyttig?