Categorias do seller
Lista as categorias em que um seller tem produtos ativos, com a contagem.
A lista reflete os produtos reais do seller, não as categorias que ele está autorizado a usar. Uma categoria sem produto ativo do seller não aparece.
/api/v1/storefront/vendors/{id}/categoriesPúblicaCategorias com produtos do seller
Lista as categorias em que o seller tem produtos ativos, com a contagem em cada uma, em ordem alfabética. Serve para o menu lateral da página do seller.
Parâmetros de caminho
idstringobrigatórioUUID ou slug do seller.
Exemplo de requisição
bash
curl "$BASE_URL/api/v1/storefront/vendors/c0000000-0000-0000-0000-000000000002/categories"Resposta
200Categorias do seller
json
{
"categories": [
{ "id": "0d209d61-abda-4424-945f-8bd538e9bb5a", "name": "Air Fryers", "slug": "air-fryers", "product_count": 143 },
{ "id": "1c19baa0-8188-47d4-87ed-2ab6ac05bec3", "name": "Aspiradores", "slug": "aspiradores", "product_count": 128 }
]
}Campos da resposta
categoriesobject[]Categorias com produtos ativos do seller, por nome.
categories[].iduuidId da categoria.
categories[].namestringNome.
categories[].slugstringSlug da categoria.
categories[].product_countintegerProdutos ativos do seller nessa categoria.
Erros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Loja que exige login para navegar e chamada sem token. | {"error":"shopping_requires_login","message":"this storefront requires login to browse"} |
| 404 | Seller inexistente. | {"error":"vendor not found"} |
| 500 | Falha ao ler as categorias. | {"error":"failed to get vendor categories","detail":"..."} |