Exportar lista de Canvas
/canvas/list
Utiliza este punto final para exportar una lista de Canvas, incluyendo el nombre, el identificador de la API de Canvas y las etiquetas asociadas.
Los lienzos se devuelven en grupos de 100 ordenados por fecha de creación (de más antiguo a más reciente por predeterminado).
Los lienzos archivados no se incluirán en la respuesta de la API a menos que se especifique el campo include_archived. Sin embargo, los lienzos parados pero no archivados se devolverán predeterminadamente.
Requisitos previos
Para utilizar este punto final, necesitarás una clave de API con el permiso canvas.list.
Límite de velocidad
Aplicamos el límite de velocidad predeterminado de Braze de 250 000 solicitudes por hora a este punto final, como se documenta en Límites de velocidad de la API.
Parámetros de la solicitud
| Parámetro | Obligatoria | Tipo de datos | Descripción |
|---|---|---|---|
page |
Opcional | Entero | La página de Lienzos a devolver, predeterminada a 0 (devuelve el primer conjunto de hasta 100) |
include_archived |
Opcional | Booleano | Incluir o no los Canvas archivados, de manera predeterminada, false. |
sort_direction |
Opcional | Cadena | - Ordenar la hora de creación de más reciente a más antigua: introduce el valor desc.- Ordenar la hora de creación de más antiguo a más reciente: introduce el valor asc. Si no se incluye sort_direction, el orden predeterminado es del más antiguo al más reciente. |
last_edit.time[gt] |
Opcional | Tiempo | Filtra los resultados y sólo devuelve los lienzos que se hayan editado más del tiempo indicado hasta ahora. El formato es yyyy-MM-DDTHH:mm:ss. |
Ejemplo de solicitud
1
2
curl --location -g --request GET 'https://rest.iad-01.braze.com/canvas/list?page=1&include_archived=false&sort_direction=desc&last_edit.time[gt]=2020-06-28T23:59:59-5:00' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Respuesta
1
2
3
4
5
6
7
8
9
10
11
12
13
14
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"canvases" : [
{
"id" : (string) the Canvas API identifier,
"last_edited": (ISO 8601 string) the last edited time for the message,
"name" : (string) the Canvas name,
"tags" : (array) the tag names associated with the Canvas formatted as strings,
},
... (more Canvases)
],
"message": (required, string) the status of the export, returns 'success' when completed without errors
}
Para obtener ayuda con las exportaciones CSV y API, visita Solución de problemas de exportación.
Editar esta página en GitHub