캔버스 세부 정보 내보내기
get
/canvas/details
이 엔드포인트를 사용하여 이름, 생성 시간, 현재 상태 등과 같은 캔버스에 대한 메타데이터를 내보낼 수 있습니다.
필수 구성 요소
이 엔드포인트를 사용하려면 canvas.details 권한이 있는 API 키가 필요합니다.
사용량 제한
요청 매개변수
| 매개변수 | 필수 | 데이터 유형 | 설명 |
|---|---|---|---|
canvas_id |
필수 | 문자열 | 캔버스 API 식별자 참조 |
요청 예시
1
2
curl --location -g --request GET 'https://rest.iad-01.braze.com/canvas/details?canvas_id={{canvas_identifier}}' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
응답
note:
모든 캔버스 단계에는 {name, next_step_id} 데이터 배열인 next_paths 필드가 있습니다. 전체 단계 및 메시지 단계의 경우 필드가 next_step_ids 표시되지만 다른 캔버스 흐름 단계에 대한 데이터는 포함되지 않습니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"created_at": (string) the date created as ISO 8601 date,
"updated_at": (string) the date updated as ISO 8601 date,
"name": (string) the Canvas name,
"description": (string) the Canvas description,
"archived": (boolean) whether this Canvas is archived,
"draft": (boolean) whether this Canvas is a draft,
"schedule_type": (string) the type of scheduling action,
"first_entry": (string) the date of first entry as ISO 8601 date,
"last_entry": (string) the date of last entry as ISO 8601 date,
"channels": (array of strings) step channels used with Canvas,
"variants": [
{
"name": (string) the name of variant,
"id": (string) the API identifier of the variant,
"first_step_ids": (array of strings) the API identifiers for first steps in variant,
"first_step_id": (string) the API identifier of first step in variant (deprecated in November 2017, only included if the variant has only one first step)
},
... (more variations)
],
"tags": (array of strings) the tag names associated with the Canvas,
"teams" : (array) the names of the Teams associated with the Canvas,
"steps": [
{
"name": (string) the name of step,
"type" (string) the type of Canvas component,
"id": (string) the API identifier of the step,
"next_step_ids": (array of strings) IDs for next steps that are full steps or Message steps,
"next_paths": { (array of objects)
// for Decision Splits, this property should evaluate to "Yes" or "No"
// for Audience Path and Action Paths, this property should evaluate to the group name
// for Experiment Paths, this property should evaluate to the path name
// for other steps, this property should evaluate to "null"
"name": (string) name the name of step,
"next_step_id": (string) IDs for next steps that are full steps or Message steps,
}
"channels": (array of strings) the channels used in step,
"messages": {
"message_variation_id": (string) { // <=This is the actual id
"channel": (string) the channel type of the message (for example, "email"),
// channel-specific fields for this message, see Campaign Details endpoint API Response for example message responses
}
}
},
... (more steps)
],
"message": (required, string) the status of the export, returns 'success' when completed without errors
}
채널별 메시지
다음은 다양한 채널(이메일, 푸시, SMS, 인앱 메시지)을 통해 전송된 캔버스 메시지가 포함된 응답 예시입니다:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
{
"message": "success",
"created_at": "2023-01-01T12:00:00Z",
"updated_at": "2023-01-10T12:00:00Z",
"name": "Multi-Channel Engagement",
"description": "Complete profile reminder via multiple channels",
"archived": false,
"draft": false,
"schedule_type": "date",
"first_entry": "2023-01-01T12:00:00Z",
"last_entry": "2023-01-10T12:00:00Z",
"channels": ["email", "push", "sms", "in_app_message"],
"variants": [
{
"name": "Variant 1",
"id": "variant_1_id",
"first_step_ids": ["step_1"]
}
],
"tags": ["engagement", "multi-channel"],
"teams": ["Marketing Team"],
"steps": [
{
"name": "Welcome Email",
"type": "email",
"id": "step_1",
"next_step_ids": ["step_2"],
"next_paths": [
{
"name": "Next Step",
"next_step_id": "step_2"
}
],
"channels": ["email"],
"messages": {
"message_1": {
"channel": "email",
"subject": "Welcome to Kitchenerie!",
"body": "<html><body>Welcome to the Kitchenerie family, !</body></html>",
"created_at": "2023-01-01T12:00:00Z",
"updated_at": "2023-01-01T12:00:00Z"
}
}
},
{
"name": "Follow-Up Push Notification",
"type": "push",
"id": "step_2",
"next_step_ids": ["step_3"],
"next_paths": [
{
"name": "Next Step",
"next_step_id": "step_3"
}
],
"channels": ["push"],
"messages": {
"message_2": {
"channel": "push",
"title": "Don't Forget to Complete Your Kitchenerie Profile",
"body": "Complete your Kitchenerie profile for access to special offers and local events.",
"created_at": "2023-01-02T12:00:00Z",
"updated_at": "2023-01-02T12:00:00Z"
}
}
},
{
"name": "Reminder SMS",
"type": "sms",
"id": "step_3",
"next_step_ids": ["step_4"],
"next_paths": [
{
"name": "Next Step",
"next_step_id": "step_4"
}
],
"channels": ["sms"],
"messages": {
"message_3": {
"channel": "sms",
"body": "Hi , remember to complete Kitchenerie your profile!",
"created_at": "2023-01-03T12:00:00Z",
"updated_at": "2023-01-03T12:00:00Z"
}
}
},
{
"name": "In-App Message",
"type": "in_app_message",
"id": "step_4",
"next_step_ids": [],
"next_paths": [],
"channels": ["in_app_message"],
"messages": {
"message_4": {
"channel": "in_app_message",
"header": "Complete Your Kitchenerie Profile",
"body": "Complete your Kitchenerie profile to unlock access to savings and local events!",
"created_at": "2023-01-04T12:00:00Z",
"updated_at": "2023-01-04T12:00:00Z"
}
}
}
],
"entry_criteria": {
"segment_id": "new_users_segment"
},
"exit_criteria": {
"event_name": "completed_profile"
}
}
tip:
CSV 및 API 내보내기에 대한 도움말은 내보내기 문제 해결을 참조하세요.
GitHub 에서 이 페이지를 편집합니다.
이 페이지가 얼마나 도움이 되었나요?
New Stuff!