删除一个 File。
DELETE /api/v1/cloud/files/{file_id}
删除 File 并返回删除确认。
路径参数
参数 | 类型 | 说明 |
| string | File ID,前缀为 |
请求头
头部 | 必选 | 说明 |
| 是 |
|
示例请求
curl -X DELETE https://api.qoder.com.cn/api/v1/cloud/files/file_019e3bb8c1387743bf4ef115aae5acb1 \
-H "Authorization: Bearer $QODER_PAT"
示例响应
HTTP 200 OK
{
"id": "file_019e3bb8c1387743bf4ef115aae5acb1",
"type": "file_deleted"
}
删除成功通过响应体中的 "type": "file_deleted" 标识。
错误码
HTTP | type | 触发条件 |
401 |
| 缺少或无效的认证令牌 |
404 |
| 文件不存在 |
409 |
| 文件仍被活跃资源引用 |
完整错误信封说明详见 错误参考。