Referencia · Catálogo
Lista paginada de productos
Devuelve productos EN_VENTA y AGOTADO, del más nuevo al más viejo. Los borradores y archivados nunca aparecen. Los filtros por atributo y por precio no están disponibles todavía.
Cada producto trae solo su primera imagen; GET /products/{id} las trae todas.
Bajo una ráfaga, esta lectura y la del detalle pueden servir la última respuesta conocida, de hasta 10 minutos, o responder 429 si no hay ninguna. Nunca responden un catálogo vacío por eso. Con pk_ aplican los límites por visitante de la tienda; con sk_, solo el total de la tienda.
Parámetros de consulta
qtextoBúsqueda sin distinguir acentos. Cada palabra tiene que aparecer en el nombre, la descripción, la categoría o las etiquetas.
Máximo 100 caracteres.
categoryIdtextoFiltra por categoría; una categoría raíz incluye sus subcategorías visibles. Una categoría oculta, inexistente o de otra tienda devuelve una página vacía.
De 1 a 64 caracteres.
pageenteroDe 1 a 100000, por defecto 1.
limitenteroDe 1 a 100, por defecto 24.
Respuestas
| Estado | Código | Qué significa |
|---|---|---|
| 200 | — | Página de productos. |
| 400 |
| Solicitud rechazada. Con |
| 401 |
| Clave ausente, inválida o revocada: |
| 403 |
|
|
| 429 |
|
|
| 500 | — | Error del servidor. En el checkout se puede reintentar con la misma |
| 503 |
|
|