Buscar Produtos

​

📌 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/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/products?cursor=v1:SEU_CURSOR_AQUI&limit=20"

{
	"status": true,
	"code": "PRODUCTS_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_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 cadastrado
• 403 NO_ACTIVE_SUBSCRIPTION (ou similar) → plano inativo/expirado
• 500 INTERNAL_SERVER_ERROR → erro interno