Skip to content

Actualizar traducción en un Canvas

put

/canvas/translations

Usa este endpoint para actualizar múltiples traducciones de un Canvas. Consulta Configuraciones regionales en los mensajes para obtener más información sobre las características de localización.

Si deseas actualizar las traducciones después de haber lanzado un Canvas, primero deberás guardar tu mensaje como borrador.

Requisitos previos

Para utilizar este endpoint, necesitarás una clave de API con el permiso canvas.translations.update.

Límite de velocidad

Este endpoint tiene un límite de velocidad de 250 000 solicitudes por minuto.

Parámetros de ruta

No hay parámetros de ruta para este endpoint.

Parámetros de la solicitud

Parámetro Obligatorio Tipo de datos Descripción
workflow_id Obligatorio Cadena El ID del Canvas.
step_id Obligatorio Cadena El ID de tu paso en Canvas.
message_variation_id Obligatorio Cadena El ID de tu variación de mensaje.
locale_id Obligatorio Cadena El ID (UUID) de la configuración regional.
translation_map Obligatorio Objeto Objeto que contiene las nuevas traducciones.

Ejemplo de solicitud

1
2
3
4
5
6
7
8
9

{
    "workflow_id": "a74404b3-3626-4de0-bdec-06935f3aa0ad",
    "step_id": "a74404b3-3626-4de0-bdec-06935f3aa0ac",
    "message_variation_id": "a74404b3-3626-4de0-bdec-06935f3aa0ac",
    "locale_id": "h94404b3-3626-4de0-bdec-06935f3aa0ad",
    "translation_map": {
        "id_3": "Ein Absatz ohne Formatierung"
    }
}

Respuesta

Hay cuatro respuestas de código de estado para este endpoint: 200, 400, 404 y 429.

Ejemplo de respuesta correcta

1
2
3

{
	"message": "success"
}

Ejemplo de respuesta de error

El código de estado 400 podría devolver el siguiente cuerpo de respuesta. Consulta Solución de problemas para obtener más información sobre los errores que puedes encontrar.

1
2
3
4
5
6
7

{
	"errors": [
		{
			"message": "The provided locale code does not exist."
		}
	]
}
New Stuff!