Ver valores de origem padrão para as tags de tradução de um Canvas
/canvas/translations/source
Use este endpoint para ver todas as fontes de tradução padrão para as tags de tradução de um Canvas. Estes são os valores com o
{% translation id %} source {% endtranslation %}. Consulte Locais em mensagens para saber mais sobre os recursos de tradução.
This endpoint está atualmente em acesso antecipado. Entre em contato com seu gerente de conta Braze se estiver interessado em participar do acesso antecipado.
Pré-requisitos
Para usar esse endpoint, você precisará de uma chave de API com a permissão canvas.translations.get.
Limite de taxa
Esse endpoint tem um limite de taxa de 250.000 solicitações por minuto.
Parâmetros de consulta
| Parâmetro | Obrigatória | Tipo de dados | Descrição |
|---|---|---|---|
workflow_id |
Obrigatória | String | O ID do Canvas. |
step_id |
Obrigatória | String | O ID da sua etapa do Canvas. |
message_variation_id |
Obrigatória | String | O ID da sua variação de mensagem. |
locale_id |
Opcional | String | O ID (UUID) do local. |
post_launch_draft_version |
Opcional | booleano | Quando true, retorna a versão de rascunho mais recente em vez da versão publicada mais recente. O padrão é false, retornando a versão publicada mais recente. |
Todos os IDs de tradução são considerados identificadores únicos universais (UUIDs), que podem ser encontrados na resposta do endpoint GET.
Exemplo de solicitação
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/canvas/translations/source?workflow_id={workflow_id}&step_id={step_id}&message_variation_id={message_variation_id}&locale_id={locale_uuid}&post_launch_draft_version=true' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Resposta
Há quatro respostas de código de status para esse endpoint: 200, 400, 404 e 429.
Exemplo de resposta bem-sucedida
O código de status 200 poderia retornar o seguinte cabeçalho e corpo de resposta.
1
2
3
4
5
6
7
8
9
{
"translations": {
"translation_map": {
"id_0": "Here's a Million Dollars",
"id_1": "Hello World!"
}
},
"message": "success"
}
Exemplo de resposta de erro
O código de status 400 poderia retornar o seguinte corpo de resposta. Consulte Solução de problemas para obter mais informações sobre os erros que você pode encontrar.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "This message does not support multi-language."
}
]
}