Criar grupo
Cria um grupo de características, como Dimensões ou Especificações Técnicas, para organizar a ficha técnica dos produtos.
Use esta operação para criar o título que vai reunir características. O grupo nasce vazio: depois, crie as características dele com group_id em Criar característica. Se você quer que todas as características do bloco valham só para algumas categorias, defina categories_path no grupo antes de criar as filhas, porque elas copiam esse valor na criação.
/api/v1/admin/feature-groupsAdminCriar um grupo de características
Responde 201 com o grupo criado. O feature_type é fixado em group, mesmo que você envie outro valor. Exige o privilégio manage_features.
Corpo da requisição
namestringobrigatóriodescriptionstringcodestringcategories_pathstringpadrão: display_on_productbooleanpadrão: falsepositionintegerpadrão: 0descriptionsobject{"name": "..."}. Em grupo, só o nome é gravado./api/v1/admin/characteristic-groupsAdminApelido em português: criar um grupo de características
Apelido de /api/v1/admin/feature-groups: mesmo corpo, mesmas regras.
Exemplo de requisição
Resposta
Os campos são os de Listar grupos. Guarde o id: é o group_id das características filhas.
Erros
| Status | Quando | Corpo |
|---|---|---|
| 400 | Corpo que não é JSON | {"error":"invalid request body","detail":"..."} |
| 400 | name ausente | {"error":"name is required"} |
| 400 | Nome vazio depois de remover o HTML | {"error":"failed to create feature","detail":"name_required: feature name must not be empty after sanitization"} |
| 401 | Sem credenciais ou token expirado | {"error":"missing authorization header"} |
| 403 | Sem o privilégio manage_features | {"error":"insufficient privileges","required":"manage_features"} |
| 409 | Já existe um grupo com esse nome | {"error":"failed to create feature","detail":"duplicate_group_name: a group named \"Dimensões da embalagem\" already exists"} |