Skip to content

Übersetzung in einem Canvas aktualisieren

put

/canvas/translations

Verwenden Sie diesen Endpunkt, um mehrere Übersetzungen für ein Canvas zu aktualisieren. Weitere Informationen zu den Übersetzungsfeatures finden Sie unter Locales in Nachrichten.

Wenn Sie Übersetzungen aktualisieren möchten, nachdem ein Canvas gestartet wurde, müssen Sie zunächst Ihre Nachricht als Entwurf speichern.

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung canvas.translations.update.

Rate-Limit

Dieser Endpunkt hat ein Rate-Limit von 250.000 Anfragen pro Minute.

Pfadparameter

Für diesen Endpunkt gibt es keine Pfadparameter.

Anfrageparameter

Parameter Erforderlich Datentyp Beschreibung
workflow_id Erforderlich String Die ID des Canvas.
step_id Erforderlich String Die ID Ihres Canvas-Schritts.
message_variation_id Erforderlich String Die ID Ihrer Nachrichtenvariante.
locale_id Erforderlich String Die ID (UUID) der Locale.
translation_map Erforderlich Objekt Objekt, das die neuen Übersetzungen enthält.

Beispielanfrage

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

Antwort

Es gibt vier Statuscode-Antworten für diesen Endpunkt: 200, 400, 404 und 429.

Beispiel für eine erfolgreiche Antwort

1
2
3

{
	"message": "success"
}

Beispiel für eine Fehlerantwort

Der Statuscode 400 könnte den folgenden Antworttext zurückgeben. Unter Fehlerbehebung finden Sie weitere Informationen zu Fehlern, die auftreten können.

1
2
3
4
5
6
7

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