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:

1. Gå til fanen Projektindstillinger, API.
2. Rul til afsnittet Webhooks og klik på Tilføj Webhook.
3. Angiv webhook-navnet og URlL’en, der skal modtage forespørgsler.
4. Vælg en passende forespørgselsmetode GET eller POST. Vælges POST – vælg en indholdstype for denne forespørgselsmetode.
5. Vælg en enkelt begivenhed eller et sæt begivenheder at blive notificeret om.
6. Klik på Test for at tjekke, hvilket notificeringsindhold du vil modtage.
7. 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:

{ "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}} }

Oversættelsesforslag tilføjet

Webhook’en vil blive udløst, når en streng i projektet bliver oversat.

Eksempel på indhold:

{ "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}} }

Oversættelsesforslag opdateret

Webhook’en udløses, når tidligere tilføjet oversættelse til en streng i projektet opdateres.

Eksempel på indhold:

{ "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}} }

Oversættelsesforslag slettet

Webhook’en udløses, når tidligere tilføjet oversættelse til strengen slettes.

Eksempel på indhold:

{ "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}} }

Oversættelsesforslag godkendt

Webhook’en udløses, når tidligere tilføjet oversættelse til strengen godkendes.

Eksempel på indhold:

{ "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}} }

Oversættelsesforslag afvist

Webhook’en udløses, når tidligere tilføjet oversættelse til strengen afvises.

Eksempel på indhold:

{ "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}} }

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.