Productos - Karrito Docs

#Consultar productos

GET /api/v1/products
GET /api/v1/products/ID_DEL_PRODUCTO

La lectura requiere llave válida, permiso read y acceso a la tienda. Un listado devuelve { data, total, limit, offset }; un recurso individual, { data: producto }.

Filtro de listado	Uso
`limit`, `offset`	Paginación: 50 por defecto y máximo 100 por página.
`status`	`active`, `inactive` o `all`; por defecto `active`.
`q`	Búsqueda de catálogo.
`sku`, `barcode`	Coincidencia exacta del identificador.

curl "https://karrito.app/api/v1/products?status=all&limit=20"   -H "Authorization: Bearer $KARRITO_API_KEY"

No encontrar un producto entre los activos no acredita que esté borrado. Un filtro exacto sin coincidencia devuelve un listado vacío, no necesariamente 404.

#Campos y categorías

El listado incluye identificación, nombre, slug, descripción, precios, imágenes, estado, inventario, SKU/código de barras y pertenencias a categorías, entre otros campos. Los importes decimales pueden estar serializados como texto.

categoryIds describe las categorías del producto; categoryId es el alias de la primera por compatibilidad. No se limita cada producto a una categoría.

#Crear un producto

POST /api/v1/products

Requiere products:write. El cuerpo mínimo incluye nombre y precio numérico no negativo:

{
  "name": "Camiseta básica",
  "price": 590,
  "isActive": true
}

Campos opcionales incluyen description, categoryIds, imageUrl y comparePrice. El precio comparativo, si se usa, debe ser mayor que el precio de venta. Las categorías deben existir en la tienda. El servidor comprueba permisos y capacidad: un cuerpo válido no garantiza acceso ni cupo.

#Actualizar y borrar

PUT /api/v1/products/ID_DEL_PRODUCTO
DELETE /api/v1/products/ID_DEL_PRODUCTO

Las escrituras requieren products:write. Una actualización debe incluir al menos un cambio válido. Revisa el contrato de los campos antes de modificar variantes, imágenes o pertenencias; no uses una lista incompleta como reemplazo de toda la información.

El borrado del producto utiliza borrado lógico. No se anuncia una función pública de restauración a partir de ello: ocultar temporalmente mediante estado y borrar son acciones distintas.

Consulta Autenticación, Variantes y Categorías.