캔버스에 대한 번역 보기
get
/canvas/translations
이 엔드포인트를 사용하여 캔버스에 대한 번역된 메시지를 미리 볼 수 있습니다. 번역 기능에 대한 자세한 내용은 메시지의 로케일을(를) 참조하십시오.
important:
이 엔드포인트는 현재 얼리 액세스 중입니다. Contact your Braze account manager if you’re interested in participating in the early access.
Prerequisites
이 엔드포인트를 사용하려면 canvas.translations.get 권한이 있는 API 키가 필요합니다.
사용량 제한
이 엔드포인트의 속도 제한은 분당 250,000건의 요청입니다.
쿼리 매개변수
| 매개변수 | 필수 | 데이터 유형 | 설명 |
|---|---|---|---|
workflow_id |
Required | 문자열 | 캔버스의 ID입니다. |
step_id |
Required | 문자열 | 캔버스 단계의 ID입니다. |
message_variation_id |
Required | 문자열 | 메시지 변형의 ID입니다. |
locale_id |
Optional | 문자열 | 로케일의 ID (UUID)입니다. |
post_launch_draft_version |
선택 사항 | 부울 | true이(가) 최신 라이브 게시 버전 대신 최신 초안 버전을 반환할 때입니다. 기본적으로 false는 최신 라이브 버전을 반환합니다. |
note:
모든 번역 ID는 보편적 고유 식별자 (UUID)로 간주되며, GET 엔드포인트의 응답에서 찾을 수 있습니다.
예시 요청
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'
응답
이 엔드포인트에 대한 상태 코드 응답은 200, 400, 404, 429 의 네 가지가 있습니다.
성공 응답의 예
200 상태 코드는 다음과 같은 응답 헤더와 본문을 반환할 수 있습니다.
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"
}
}
]
}
오류 응답의 예
400 상태 코드는 다음과 같은 응답 본문을 반환할 수 있습니다. 발생할 수 있는 오류에 대한 자세한 내용은 문제 해결을 참조하세요.
1
2
3
4
5
6
7
{
"errors": [
{
"message": "The provided locale code does not exist."
}
]
}
New Stuff!
GitHub 에서 이 페이지를 편집합니다.