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

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

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.