Exclua permanentemente e de forma irreversível um arquivo pelo ID.
Parâmetros de caminho
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
file_id |
string |
Sim |
Identificador exclusivo do arquivo, com o prefixo file_ |
Cabeçalhos da requisição
|
Cabeçalho |
Obrigatório |
Descrição |
|
Authorization |
Sim |
Bearer $QODER_PAT |
Exemplo de requisição
curl -X DELETE "https://api.qoder.com.cn/api/v1/cloud/files/file_019e3bb8e4b67b7789e49ca6ecb2aae0" \
-H "Authorization: Bearer $QODER_PAT"Exemplo de resposta
HTTP 204 No Content
Uma exclusão bem-sucedida retorna HTTP 204 sem corpo de resposta.
Erros
|
HTTP |
Tipo |
Gatilho |
|
401 |
– |
Token de autenticação ausente ou inválido |
|
404 |
not_found_error |
O arquivo com o ID fornecido não existe |
Exemplo de resposta de erro
{
"error": {
"message": "File 'file_nonexistent123' was not found.",
"type": "not_found_error"
},
"type": "error"
}Observações
A exclusão é permanente e irreversível.
Após a exclusão, o endpoint de listagem deixa de retornar o arquivo.
Se uma sessão ativa referenciar o arquivo, a referência se tornará inválida após a exclusão.
Consulte Erros para ver a estrutura completa de erros.