Categorias

#Listar categorias

GET /api/v1/categories

Devuelve una lista paginada de las categorias de tu tienda, ordenadas por el campo position (la misma posicion que configuras en el admin con drag and drop).

#Parametros de query

Parametro	Tipo	Default	Descripcion
limit	number	50	Resultados por pagina (max 100)
offset	number	0	Resultados a saltar

#Ejemplo con curl

curl "https://karrito.shop/api/v1/categories" \
  -H "Authorization: Bearer krt_live_a1b2c3d4e5f6g7h8i9j0"

#Ejemplo con JavaScript

const response = await fetch("https://karrito.shop/api/v1/categories", {
  headers: {
    "Authorization": "Bearer krt_live_a1b2c3d4e5f6g7h8i9j0"
  }
});

const { data, total } = await response.json();
console.log(`${total} categorias`);

#Respuesta

{
  "data": [
    {
      "id": "clx9z8y7w6v5u4t3s2r1q0",
      "name": "Camisas",
      "slug": "camisas",
      "position": 0,
      "isActive": true
    },
    {
      "id": "clx8y7w6v5u4t3s2r1q0p9",
      "name": "Pantalones",
      "slug": "pantalones",
      "position": 1,
      "isActive": true
    },
    {
      "id": "clx7w6v5u4t3s2r1q0p9o8",
      "name": "Accesorios",
      "slug": "accesorios",
      "position": 2,
      "isActive": true
    },
    {
      "id": "clx6v5u4t3s2r1q0p9o8n7",
      "name": "Temporada",
      "slug": "temporada",
      "position": 3,
      "isActive": false
    }
  ],
  "total": 4,
  "limit": 50,
  "offset": 0
}

#Schema de categoria

Campo	Tipo	Descripcion
id	string	Identificador unico (CUID)
name	string	Nombre de la categoria
slug	string	URL-friendly del nombre
position	number	Orden de aparicion (0 = primero)
isActive	boolean	Si la categoria esta visible en el catalogo

#Notas

• Las categorias inactivas (isActive: false) se incluyen en la respuesta de la API. Si solo quieres las activas, filtralas en tu codigo
• La respuesta viene ordenada por position ascendente
• Cada producto puede pertenecer a una sola categoria (o a ninguna)

#Scope requerido

• categories:read

#Siguiente paso

Consulta las ordenes que llegan a tu tienda.