Webhooks

Os Webhooks notificam e ajudam-te a recolher informações sobre os principais eventos que acontecem no teu projeto no Crowdin, como traduções concluídas ou revisão. Estas chamadas de retorno definidos pelo utilizador, permitem que o Crowdin abra URLs previamente, definidas via HTTP.

Apenas os proprietários e gestores de projetos podem registar uma webhook.

Podes configurar webhooks para esperar pelos seguintes eventos: projeto totalmente traduzido ou revisto, ficheiro totalmente traduzido ou revisto, tradução adicionada, atualizada, apagada, aprovada ou não aprovada.

Visão geral

Fornece as seguintes informações para criar um webhook no Crowdin:

• Um nome para o webhook (por exemplo, “ App de Projeto Traduzido”).
• O URL onde a chamada de retorno deve ser enviado.
• O método de solicitação, GET ou POST, que indica a ação desejada a ser executada para um determinado recurso.
• O tipo de conteúdo (ultipart/form-data, application/json, application/x-www-form-urlencoded disponível apenas para o método de solicitação POST).
• Os eventos par postar no URL. Podes selecionar um evento ou um conjunto específico de eventos.

Adicionar Webhooks

Para configurar webhooks no Crowdin, segue estes passos:

1. Vai para as Definições do Projeto, navegador API.
2. Rola para a secção Webhooks e clica Adicionar Webhook.
3. Especifica o nome e URL do webhook para receber pedidos.
4. Seleciona um método de solicitação GET ou POST conveniente. Se selecionares POST – escolhe um tipo de conteúdo para este método de solicitação.
5. Seleciona um único evento ou conjunto de eventos para receber notificações.
6. Clica Testar para verificar qual a carga receberás.
7. Clica Adicionar para guardar as alterações.

Eventos

Podes configurar webhooks para os seguintes eventos:

Ficheiro totalmente traduzido

O webhook será acionado quando qualquer um dos teus ficheiros de projeto for totalmente traduzido.

Exemplo de carga:

{ "event": "file.translated", "project": {{project_identifier}}, "project_id": {{project_id}}, "language": {{language_code}}, "file_id": {{file_identifier}}, "file": {{file_name}} }

Ficheiro totalmente revisto

O webhook será acionado quando qualquer um dos teus ficheiros de projeto for totalmente revisto.

Exemplo de carga:

{ "event": "file.approved", "project": {{project_identifier}}, "project_id": {{project_id}}, "language": {{language_code}}, "file_id": {{file_identifier}}, "file": {{file_name}} }

Projeto totalmente traduzido

O webhook será enviado quando todas as frases do projeto estiverem traduzidas.

Exemplo de carga:

{ "event": "project.translated", "project": {{project_identifier}}, "project_id": {{project_id}}, "language": {{language_code}} }

Projeto totalmente revisto

O webhook será enviado quando todas as frases do projeto estiverem revistadas.

Exemplo de carga:

{ "event": "project.approved", "project": {{project_identifier}}, "project_id": {{project_id}}, "language": {{language_code}} }

Tradução exportada atualizada

O webhook será enviado quando a tradução final duma frase for atualizada.

Exemplo de carga:

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

Sugestão de tradução adicionada

O webhook será acionado quando uma frase do projeto for traduzida.

Exemplo de carga:

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

Sugestão de tradução atualizada

O webhook será acionado quando a tradução adicionada anteriormente, para uma frase fo projeto for atualizada.

Exemplo de carga:

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

Sugestão de tradução apagada

O webhook será acionado quando a tradução adicionada anteriormente, para a frase, for apagada.

Exemplo de carga:

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

Sugestão de tradução aprovada

O webhook será acionado quando tradução adicionada anteriormente, para a frase, for aprovada.

Exemplo de carga:

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

Sugestão de tradução desaprovada

O webhook será acionado quando a tradução adicionada anteriormente, para a frase, for desaprovada.

Exemplo de carga:

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

Editar ou Apagar Webhooks

A lista dos webhooks existentes será mostrada na secção Webhooks. Podes editar ou apagar webhooks diretamente, da lista exibida.

Histórico de Chamadas

O histórico de chamadas de todos os webhooks adicionados será acessível na mesma secção. Usa o filtro para verificar todas ou apenas as notificações mal-sucedidas do webhook.