Categorias do produto
Lista as categorias em que um produto está, com qual é a principal e os dados do vínculo.
Um produto fica em uma categoria principal e, se quiser, em várias categorias adicionais. É a principal que define o caminho da URL e a trilha de navegação (Início / Casa / Cozinha / Caneca); as adicionais só fazem o produto aparecer também nas outras listagens. Esta página mostra como ler esse vínculo.
Para trocar a categoria principal, use o campo category_id do PUT, que mantém a categoria antiga como adicional.
/api/v1.0/products/{id}/categoriesAutenticadaCategorias de um produto
Autenticação: HTTP Basic com e-mail:chave_de_api, ou Authorization: Bearer <JWT>; a leitura aceita qualquer usuário autenticado. A rota também responde em /api/products/{id}/categories, com ids decimais em string. Um produto que não existe devolve 200 com listas vazias (e não 404).
Parâmetros de caminho
idstringobrigatórioproduct_id, em UUID (na rota /api/products/{id}/categories, também o id decimal).Exemplo de requisição
curl -u "$EMAIL:$API_KEY" \
"$BASE_URL/api/v1.0/products/0497b6a8-c868-43be-ac21-2abddd24cd3c/categories"Resposta
{
"product_id": "0497b6a8-c868-43be-ac21-2abddd24cd3c",
"categories": [
{
"category_id": "345ac33e-4dcd-4d60-bedf-a2c2d47897d9",
"category": "Escritório",
"parent_id": "0",
"id_path": "345ac33e-4dcd-4d60-bedf-a2c2d47897d9",
"status": "A",
"position": 0,
"product_count": 0,
"company_id": "0",
"description": "",
"seo_name": "escritorio",
"page_title": "",
"meta_description": "",
"meta_keywords": "",
"timestamp": 1788959480,
"updated_timestamp": 1788959480
}
],
"links": [
{
"category_id": "345ac33e-4dcd-4d60-bedf-a2c2d47897d9",
"product_id": "0497b6a8-c868-43be-ac21-2abddd24cd3c",
"position": 0,
"is_primary": "Y"
}
],
"total": 1
}Campos da resposta
product_idstring/api/v1.0; decimal em /api/).categoriesarraycategories[].category_idstringcategories[].categorystringcategories[].parent_idstring"0" na raiz.categories[].id_pathstring/.categories[].statusstringADHA ativa, D desativada, H oculta.categories[].positionintegercategories[].product_countintegercategories[].company_idstring"0" para categoria da loja.categories[].descriptionstringcategories[].seo_namestringcategories[].page_titlestringcategories[].meta_descriptionstringcategories[].meta_keywordsstringcategories[].timestampintegercategories[].updated_timestampintegercategories[].main_pairobjectpair_id, image_id, detailed.image_path). Ausente quando não há imagem.linksarraylinks[].category_idstringlinks[].product_idstringlinks[].positionintegerlinks[].is_primarystringYNY na categoria principal.totalintegerErros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Sem credenciais, chave inválida ou token expirado | {"message":"Authentication required. Use HTTP Basic with email:api_key or Bearer <jwt>.","status":401} |
| 429 | Limite de requisições | {"error":"rate limit exceeded","detail":"too many requests, please try again later"} |
| 500 | {id} que não é UUID | {"message":"Failed to retrieve product categories","status":500} |