Categorías

Listar categorías

GET /api/v1/categories

Devuelve una lista paginada de las categorías de tu tienda, ordenadas por el campo position (la misma posición que configuras en el admin con drag and drop).

Parametros de query

Ejemplo con curl

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

Ejemplo con JavaScript

const response = await fetch("https://karrito.app/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 categoría

Notas

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

Scope requerido

• categories:read

Siguiente paso

Consulta las ordenes que llegan a tu tienda.