VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API legada/Guia rápido/Características

Excluir característica

Remove uma característica, desde que nenhum produto ainda tenha valor nela.

Use esta operação para apagar uma característica que não faz mais sentido no catálogo. A exclusão é permanente e leva junto as opções (variantes) da característica. Por segurança, a plataforma recusa a exclusão enquanto algum produto tiver valor gravado nela: o cliente perderia dados sem aviso. Primeiro tire o valor dos produtos que usam a característica, depois exclua.

Se você só quer esconder a característica da vitrine, não exclua: mude o status para H com Alterar característica.

DELETE/api/v1.0/features/{id}Admin

Excluir característica

Autenticação: HTTP Basic com e-mail:chave_de_api de um administrador, ou Authorization: Bearer <JWT>. Responde 204, sem corpo.

Parâmetros de caminho

iduuidobrigatório
Id da característica.
DELETE/api/features/{id}Admin

Excluir característica (forma sem versão)

Igual a /api/v1.0/features/{id}. Hoje o id precisa ser o UUID: o id decimal da lista dessa forma volta 400.

Exemplo de requisição

bash
curl -u "$EMAIL:$API_KEY" -X DELETE \
  "$BASE_URL/api/v1.0/features/6d750dc5-6207-4809-9342-f9834c93a877"

Resposta

204Característica excluída
http
HTTP/1.1 204 No Content

Erros

StatusQuandoCorpo
400Característica em uso por produtos{"message":"feature is in use by one or more products","status":400}
401Sem credenciais ou token expirado{"message":"Invalid credentials","status":401}
403Não é administrador{"message":"Forbidden: admin scope required","status":403}
404Característica inexistente{"message":"Feature not found","status":404}
Exclusão permanente

Não existe lixeira nem desfazer, e as opções da característica são apagadas junto. Confira o id com Consultar característica antes de excluir.

Veja também

  • Alterar característica
  • Consultar característica
  • Listar características
Anterior
Alterar característica
Próxima
Embalagens e caixas
Nesta página
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também