Ver la traducción de un Canvas
/canvas/translations
Utiliza este punto final para obtener una vista previa de un mensaje traducido para Canvas. Consulta Locales en los mensajes para obtener más información sobre las características de la localización.
This endpoint Actualmente se encuentra en fase de acceso anticipado. Ponte en contacto con tu director de cuentas de Braze si estás interesado en participar en el acceso anticipado.
Requisitos previos
Para utilizar este punto final, necesitarás una clave de API con el permiso canvas.translations.get.
Límite de velocidad
Este punto final tiene un límite de velocidad de 250 000 solicitudes por minuto.
Parámetros de consulta
| Parámetro | Obligatoria | Tipo de datos | Descripción |
|---|---|---|---|
workflow_id |
Obligatoria | Cadena | El ID del Canvas. |
step_id |
Obligatoria | Cadena | El ID de tu paso en Canvas. |
message_variation_id |
Obligatoria | Cadena | El ID de tu variación de mensaje. |
locale_id |
Opcional | Cadena | El ID (UUID) de la configuración regional. |
post_launch_draft_version |
Opcional | Booleano | Cuandotrue devuelve la última versión preliminar en lugar de la última versión publicada en vivo. Predeterminado,falsedevuelve la última versión en vivo. |
Todos los ID de traducción se consideran identificadores únicos universales (UUID), que se pueden encontrar en la respuesta del punto final GET.
Ejemplo de solicitud
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/canvas/translations/?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'
Respuesta
Hay cuatro respuestas de código de estado para este punto final: 200, 400, 404 y 429.
Ejemplo de respuesta positiva
El código de estado 200 podría devolver la siguiente cabecera y cuerpo de respuesta.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
"translations": [
{
"translation_map": {
"id_0": "¡Hola!",
"id_1": "Me llamo Jacky",
"id_2": "¿Dónde está la biblioteca?"
},
"locale": {
"uuid": "c7c12345-te35-1234-5678-abcdefa99r3f",
"name": "es-MX",
"country": "MX",
"language": "es",
"locale_key": "es-mx"
}
}
]
}
Ejemplo de respuesta de error
El código de estado 400 podría devolver el siguiente cuerpo de respuesta. Consulte la sección Solución de problemas para obtener más información sobre los errores que puede encontrar.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "The provided locale code does not exist."
}
]
}
Editar esta página en GitHub