Exportar detalhes do Canvas
get
/canvas/details
Use esse ponto de extremidade para exportar metadados sobre um Canva, como o nome, a hora de criação, o status atual e muito mais.
Pré-requisitos
Para usar esse endpoint, você precisará de uma chave de API com a permissão canvas.details.
Limite de taxa
We apply the default Braze rate limit of 250,000 requests per hour to this endpoint, as documented in API rate limits.
Parâmetros de solicitação
| Parâmetro | Obrigatória | Tipo de dados | Descrição |
|---|---|---|---|
canvas_id |
Obrigatória | String | Consulte Identificador da API do Canvas |
Exemplo de solicitação
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'
Respostas
note:
Todas as etapas do canva têm um campo next_paths, que é uma matriz de dados {name, next_step_id}. Para etapas completas e etapas de mensagens, o campo next_step_ids estará presente, mas não conterá dados para outras etapas do Canvas Flow.
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
}
Envio de mensagens por canal
A seguir, um exemplo de resposta que inclui mensagens do Canva enviadas por diferentes canais (e-mail, push, SMS e mensagens no app):
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
{
"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"
}
}
}
],
}
tip:
Para obter ajuda com exportações de CSV e API, acesse Resolução de problemas de exportação.
Editar esta página no GitHub
QUÃO ÚTIL FOI ESTA PÁGINA?
New Stuff!