Buscar Produtos por Categoria

​

📌 Endpoint

​

🔐 Autenticação

• Rota pública para consulta.
• A loja precisa existir e estar com plano ativo.

​

🧾 Parâmetros de rota

​

✅ Exemplo de requisição

curl -X GET "https://api.cabrapi.com.br/stores/STORE_ID/categories/CATEGORY_ID/products?page=1&limit=20"

​

🔎 Query params

​

🔄 Paginação por cursor

1. Faça a primeira chamada sem cursor.
2. Se hasMore for true, a resposta traz o campo nextCursor.
3. Envie esse nextCursor no parâmetro cursor da próxima requisição para buscar a página seguinte.

curl -X GET "https://api.cabrapi.com.br/stores/STORE_ID/categories/CATEGORY_ID/products?cursor=v1:SEU_CURSOR_AQUI&limit=20"

{
  "status": true,
  "code": "PRODUCTS_BY_CATEGORY_FETCHED",
  "products": [ /* ... */ ],
  "pagination": {
    "nextCursor": "v1:e2xFn...",
    "hasMore": true,
    "limit": 20
  }
}

• cursor e page não podem ser usados juntos (400 INVALID_PAGINATION).
• nextCursor: null com hasMore: false indicam o fim da lista (a API responde 200 com array vazio).

​

📦 Resposta de sucesso (200)

{
  "status": true,
  "code": "PRODUCTS_BY_CATEGORY_FETCHED",
  "products": [
    {
      "id": "d4f2b5ff-7ae5-4a00-8f18-5d7b6f20f2b8",
      "name": "Curso Premium",
      "disabled": false,
      "position": 1,
      "description": "Acesso completo ao conteúdo.",
      "price": 49.9,
      "image": null,
      "delivery": "DIGITAL",
      "stock": 100,
      "sold": 12,
      "storeId": "STORE_ID",
      "metadata": {},
      "createdAt": "2026-03-02T20:00:00.000Z",
      "updatedAt": "2026-03-02T20:00:00.000Z",
      "categories": [
        {
          "id": "CATEGORY_ID",
          "name": "Cursos"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1,
    "nextCursor": null,
    "hasMore": false
  }
}

A primeira chamada (sem cursor) já retorna nextCursor e hasMore na paginação, permitindo iniciar a paginação por cursor sem chamadas extras.

​

⚠️ Possíveis erros

• 400 INVALID_DATA → parâmetro inválido
• 400 INVALID_PAGINATION_LIMIT → limit fora do intervalo permitido (1 a 100)
• 400 INVALID_PAGINATION_PAGE → page inválida
• 400 INVALID_PAGINATION_CURSOR → cursor inválido ou malformado
• 400 INVALID_PAGINATION → page e cursor utilizados juntos
• 404 STORE_NOT_FOUND → loja não encontrada
• 404 PRODUCTS_NOT_FOUND → nenhum produto encontrado para a categoria
• 403 NO_ACTIVE_SUBSCRIPTION (ou similar) → plano inativo/expirado
• 500 INTERNAL_SERVER_ERROR → erro interno