Enumerar los detalles del elemento del catálogo
/catalogs/{catalog_name}/items/{item_id}
Utiliza este punto de conexión para devolver un elemento del catálogo y su contenido.
Requisitos previos
Para utilizar este punto de conexión, necesitarás una clave de API con el permiso catalogs.get_item.
Límite de velocidad
Este punto de conexión tiene un límite de velocidad compartido de 50 solicitudes por minuto entre todos los puntos finales de elementos de catálogo síncronos, como se documenta en Límites de velocidad de la API.
Parámetros de ruta
| Parámetro | Obligatorio | Tipo de datos | Descripción |
|---|---|---|---|
catalog_name |
Obligatorio | Cadena | Nombre del catálogo. |
item_id |
Obligatorio | Cadena | El ID del elemento del catálogo. |
Parámetros de la solicitud
No hay cuerpo de solicitud para este punto de conexión.
Ejemplo de solicitud
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/catalogs/restaurants/items/restaurant1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Respuesta
Hay dos respuestas de código de estado para este punto de conexión: 200 y 404.
Ejemplo de respuesta correcta
El código de estado 200 podría devolver el siguiente cuerpo de respuesta.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"items": [
{
"id": "restaurant3",
"Name": "Restaurant1",
"City": "New York",
"Cuisine": "American",
"Rating": 5,
"Loyalty_Program": true,
"Open_Time": "2022-11-01T09:03:19.967Z"
}
],
"message": "success"
}
Ejemplo de respuesta de error
El código de estado 404 podría devolver la siguiente respuesta. Consulta la sección Solución de problemas para obtener más información sobre los errores que puedas encontrar.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"errors": [
{
"id": "item-not-found",
"message": "Could not find item",
"parameters": [
"item_id"
],
"parameter_values": [
"restaurant34"
]
}
],
"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, si procede.
| Error | Solución de problemas |
|---|---|
catalog-not-found |
Comprueba que el nombre del catálogo es válido. |
item-not-found |
Comprueba que el elemento está en el catálogo. |