Excluir loja
Exclui logicamente um seller e libera o e-mail e o endereço de vitrine.
Exclui um seller. A exclusão é lógica: o registro fica no banco, mas o seller some das listas, passa a responder 404 e vai para a situação D. O endereço de vitrine e o e-mail ficam livres para um cadastro novo.
O login do dono do seller também é desativado, a menos que essa pessoa administre outro seller ativo. Não há operação para desfazer pela API.
/api/v1.0/stores/{id}AdminExcluir uma loja
Parâmetros de caminho
iduuidobrigatóriocompany_id por /api/v1.0. O id decimal que a forma /api/... devolve não é aceito aqui./api/stores/{id}AdminMesma operação, caminho alternativo
Mesmo comportamento, parâmetros e resposta de DELETE /api/v1.0/stores/{id}. Use este caminho se o seu cliente já foi escrito para ele. Na forma sem versão (/api/...) os ids saem como números decimais em string, mas os caminhos só aceitam o UUID (veja a home da seção).
/api/v1.0/vendors/{id}AdminMesma operação, caminho alternativo
Mesmo comportamento, parâmetros e resposta de DELETE /api/v1.0/stores/{id}. Use este caminho se o seu cliente já foi escrito para ele.
/api/vendors/{id}AdminMesma operação, caminho alternativo
Mesmo comportamento, parâmetros e resposta de DELETE /api/v1.0/stores/{id}. Use este caminho se o seu cliente já foi escrito para ele. Na forma sem versão (/api/...) os ids saem como números decimais em string, mas os caminhos só aceitam o UUID (veja a home da seção).
/api/v1.0/companies/{id}AdminMesma operação, caminho alternativo
Mesmo comportamento, parâmetros e resposta de DELETE /api/v1.0/stores/{id}. Use este caminho se o seu cliente já foi escrito para ele.
/api/companies/{id}AdminMesma operação, caminho alternativo
Mesmo comportamento, parâmetros e resposta de DELETE /api/v1.0/stores/{id}. Use este caminho se o seu cliente já foi escrito para ele. Na forma sem versão (/api/...) os ids saem como números decimais em string, mas os caminhos só aceitam o UUID (veja a home da seção).
Exemplo de requisição
curl -X DELETE "$BASE_URL/api/v1.0/stores/3b617148-8a28-4d07-8040-a8903b4238d6" \
-u "$EMAIL:$API_KEY"Resposta
Resposta vazia: o corpo não tem conteúdo.
Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 401 | Sem credencial. | {"status":401,"message":"Authentication required. Use HTTP Basic with email:api_key or Bearer <jwt>."} |
| 401 | E-mail ou chave de API inválidos. | {"status":401,"message":"Invalid credentials"} |
| 403 | A credencial é válida, mas o usuário não é administrador. | {"status":403,"message":"Forbidden: admin scope required"} |
| 404 | Nenhuma loja com esse UUID, ou a loja já foi excluída. | {"status":404,"message":"store not found"} |
| 500 | O id não tem formato de UUID (por exemplo o id decimal da forma /api). É uma falha conhecida: deveria ser 404. | {"status":500,"message":"..."} (mensagem interna de erro (não estável)) |