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. Disse tilpassede tilbagekald gør det muligt for Crowdin at åbne tidligere opsatte URL’er via HTTP.
Kun projektejere og -administratorer kan registrere en webhook.
Du kan opsætte webhooks til at lytte efter flg. begivenheder: Projekt fuldt oversat eller revideret, fil fuldt oversat eller revideret, oversættelse tilføjet, opdateret, slettet, godkendt eller ikke-godkendt.
Oversigt
Giv flg. oplysninger for at oprette en webhook i Crowdin:
- Et navn til webhook’en (f.eks. “App-projekt oversat”).
- URL’en, hvortil tilbagekaldet skal sendes.
- Forespørgselsmetoden, enten GET eller POST, der angiver den ønskede handling, der skal udføres for en given ressource.
- Indholdstypen (multipart/form-data, application/json, application/x-www-form-urlencoded kun tilgængelig for POST-forespørgselsmetoden).
- Begivenhederne, som skal tilsendes URL’en. Du kan vælge enten en begivenhed eller et bestemt sæt begivenheder.
Tilføjelse af Webhooks
Følg disse trin for at opsætte webhooks i Crowdin:
- Gå til fanen Projektindstillinger, API.
- Rul til afsnittet Webhooks og klik på Tilføj Webhook.
- Angiv webhook-navnet og URlL’en, der skal modtage forespørgsler.
- Vælg en passende forespørgselsmetode GET eller POST. Vælges POST – vælg en indholdstype for denne forespørgselsmetode.
- Vælg en enkelt begivenhed eller et sæt begivenheder at blive notificeret om.
- Klik på Test for at tjekke, hvilket notificeringsindhold du vil modtage.
- Klik på Tilføj for at gemme ændringerne.
Begivenheder
Du kan opsætte webhooks til flg. begivenheder:
File fuldt oversat
Webhook’en udløses, når en af dine projektfiler når statussen fuldt oversat.
Eksempel på indhold:
{
"event": "file.translated",
"project": {{project_identifier}},
"project_id": {{project_id}},
"language": {{language_code}},
"file_id": {{file_identifier}},
"file": {{file_name}}
}Fil er fuldt revideret
Webhook’en udløses, når en af dine projektfiler når statussen fuldt revideret.
Eksempel på indhold:
{
"event": "file.approved",
"project": {{project_identifier}},
"project_id": {{project_id}},
"language": {{language_code}},
"file_id": {{file_identifier}},
"file": {{file_name}}
}Projekt er fuldt oversat
Webhook’en vil blive sendt, når alle strenge i projektet er oversat.
Eksempel på indhold:
{
"event": "project.translated",
"project": {{project_identifier}},
"project_id": {{project_id}},
"language": {{language_code}}
}Projekt fuldt revideret
Webhook’en vil blive sendt, når alle strenge i projektet er revideret.
Eksempel på indhold:
{
"event": "project.approved",
"project": {{project_identifier}},
"project_id": {{project_id}},
"language": {{language_code}}
}Eksporteret oversættelse opdateret
Webhook sendes, når den endelige oversættelse af en streng opdateres.
Eksempel på indhold:
{
"handling": "translation.updated",
"projekt": {{project_identifier}},
"projekt_id": {{project_id}},
"sprog": {{language_code}},
"kildestreng_id": {{source_string_identifier}},
"gammel_oversættelses-id": {{old_translation_identifier}},
"ny_oversættelses-id": {{new_translation_identifier}},
"bruger": {{user_name}},
"bruger-id" {{user_identifier}},
"fil-id": {{file_identifier}},
"file": {{file_name}}
}Oversættelsesforslag tilføjet
Webhook’en vil blive udløst, når en streng i projektet bliver oversat.
Eksempel på indhold:
{
"handling": "suggestion.added",
"projekt": {{project_identifier}},
"projekt-id": {{project_id}},
"sprog": {{language_code}},
"fil-id": {{file_identifier}},
"fil": {{file_name}},
"kildestrengs-id": {{source_string_identifier}},
"oversættelses-id": {{translation_identifier}},
"bruger": {{user_name}},
"bruger-id": {{user_identifier}}
}Oversættelsesforslag opdateret
Webhook’en udløses, når tidligere tilføjet oversættelse til en streng i projektet opdateres.
Eksempel på indhold:
{
"handling": "suggestion.updated",
"projekt": {{project_identifier}},
"projekt-id": {{project_id}},
"sprog": {{language_code}},
"fil-id": {{file_identifier}},
"fil": {{file_name}},
"kildestreng_id": {{source_string_identifier}},
"oversættelses-id": {{translation_identifier}},
"bruger": {{user_name}},
"bruger-id": {{user_identifier}}
}Oversættelsesforslag slettet
Webhook’en udløses, når tidligere tilføjet oversættelse til strengen slettes.
Eksempel på indhold:
{
"handling": "suggestion.deleted",
"projekt": {{project_identifier}},
"projekt-id": {{project_id}},
"sprog": {{language_code}},
"fil-id": {{file_identifier}},
"fil": {{file_name}},
"kildestrengs-id": {{source_string_identifier}},
"oversættelses-id": {{translation_identifier}},
"bruger": {{user_name}},
"bruger-id": {{user_identifier}}
}Oversættelsesforslag godkendt
Webhook’en udløses, når tidligere tilføjet oversættelse til strengen godkendes.
Eksempel på indhold:
{
"handling": "suggestion.approved",
"projekt": {{project_identifier}},
"projekt-id": {{project_id}},
"sprog": {{language_code}},
"fil-id": {{file_identifier}},
"fil": {{file_name}},
"kildestrengs-id": {{source_string_identifier}},
"oversættelses-id": {{translation_identifier}},
"bruger": {{user_name}},
"bruger-id": {{user_identifier}}
}Oversættelsesforslag afvist
Webhook’en udløses, når tidligere tilføjet oversættelse til strengen afvises.
Eksempel på indhold:
{
"handling": "suggestion.disapproved",
"projekt": {{project_identifier}},
"projekt-id": {{project_id}},
"sprog": {{language_code}},
"fil-id": {{file_identifier}},
"fil": {{file_name}},
"kildesteings-id": {{source_string_identifier}},
"oversættelses-id": {{translation_identifier}},
"bruger": {{user_name}},
"bruger-id": {{user_identifier}}
}Redigere eller Slette Webhooks
Listen over eksisterende webhooks vil blive vist i Webhooks-afsnittet. Du kan redigere eller slette webhooks direkte fra den viste liste.
Kaldhistorik
Kaldhistorie for alle de tilføjede webhooks vil være tilgængelig i samme afsnit. Benyt filteret til at markere alle eller kun mislykkede webhook-notifikationer.
