API 平台

删除文件

删除文件记录与资产引用。

DELETE
/v1/files/{file_id}

file_id 删除文件记录与资产引用,返回带 deleted: true 的 file 对象。

认证

在请求头中加入 Authorization: Bearer <API_KEY> 完成鉴权,密钥可在控制台「API 密钥」页生成。

示例
curl https://api.mosi.cn/v1/files \
  -H "Authorization: Bearer $MOSS_API_KEY"

请求参数

路径参数类型必填说明
file_idstring

POST /v1/files 返回的 id

请求示例

示例
curl -X DELETE "https://api.mosi.cn/v1/files/<file_id>" \
  -H "Authorization: Bearer $MOSS_API_KEY"

响应字段

字段类型必返说明
idstring

被删除文件的 id。

objectstring

固定为 file

deletedboolean

固定为 true,表示删除成功。

响应示例

响应示例
{
  "id": "<file_id>",
  "object": "file",
  "deleted": true
}

下一步