Eliminar varios elementos del catálogo
/catalogs/{catalog_name}/items
Usa este punto de conexión para eliminar varios elementos de tu catálogo.
Cada solicitud puede admitir hasta 50 elementos. Este punto de conexión es asíncrono.
Requisitos previos
Para utilizar este punto de conexión, necesitarás una clave de API con el permiso catalogs.delete_items.
Límite de velocidad
Este punto de conexión tiene un límite de velocidad compartido de 16 000 solicitudes por minuto entre todos los puntos finales de elementos de catálogo asíncronos, como se documenta en Límites de velocidad de la API.
Parámetros de la ruta
| Parámetro | Obligatorio | Tipo de datos | Descripción |
|---|---|---|---|
catalog_name |
Obligatorio | Cadena | Nombre del catálogo. |
Parámetros de la solicitud
| Parámetro | Obligatorio | Tipo de datos | Descripción |
|---|---|---|---|
items |
Obligatorio | Matriz | Un array que contiene objetos de elemento. Los objetos de elemento deben contener un id que haga referencia a los elementos que Braze debe eliminar. Se permite un máximo de 50 objetos por solicitud. |
Ejemplo de solicitud
1
2
3
4
5
6
7
8
9
10
curl --location --request DELETE 'https://rest.iad-03.braze.com/catalogs/restaurants/items' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
"items": [
{"id": "restaurant1"},
{"id": "restaurant2"},
{"id": "restaurant3"}
]
}'
Respuesta
Existen tres respuestas de código de estado para este punto de conexión: 202, 400 y 404.
Ejemplo de respuesta correcta
El código de estado 202 podría devolver el siguiente cuerpo de respuesta.
1
2
3
{
"message": "success"
}
Ejemplo de respuesta de error
El código de estado 400 podría devolver el siguiente cuerpo de respuesta. Consulta la sección Solución de problemas para obtener más información sobre los errores que puedes encontrar.
1
2
3
4
5
6
7
8
9
10
11
{
"errors": [
{
"id": "items-missing-ids",
"message": "There are 1 item(s) that do not have ids",
"parameters": [],
"parameter_values": []
}
],
"message": "Invalid Request"
}
Solución de problemas
La siguiente tabla enumera los posibles errores devueltos y sus pasos asociados para la solución de problemas.
| Error | Solución de problemas |
|---|---|
catalog-not-found |
Comprueba que el nombre del catálogo es válido. |
ids-too-large |
Los ID de los elementos no pueden tener más de 250 caracteres. |
ids-not-unique |
Comprueba que los ID de los elementos sean únicos en la solicitud. |
ids-not-strings |
Los ID de los elementos deben ser de tipo cadena. |
items-missing-ids |
Algunos elementos no tienen ID de elemento. Comprueba que cada elemento tiene un ID de elemento. |
invalid-ids |
Los ID de elementos solo pueden incluir letras, números, guiones y guiones bajos. |
request-includes-too-many-items |
Tu solicitud tiene demasiados elementos. El límite de elementos por solicitud es de 50. |