1. 删除文件

删除文件,删除key为{key}的文件。

请求方式:DELETE

请求地址:/bosdocumentservice/{appKey}/files/{key}?delRelation={ delRelation}

1.1. 请求参数:

Headers:

参数名 类型 示例 是否必填 参数含义
Authorization string c4570cb9ca324bc8ba7dd9d1967710ea access_token

PathParas:

参数名 类型 示例 是否必填 参数含义
appKey string xb05cd3a35614caa85c0f8f86c58fcc1 应用Key
key string Z3JvdXAxLE0wMC8wMC84RS93S2dGQ 文件Key

SearchParas:

参数名 类型 示例 是否必填 参数含义
delRelation string true/false true表示删除关联关系;false表示不删除任何关联关系,如有关系存在返回错误信息
transactionCode string 3MD2XzN70VkcvbXllg7x7V 业务事务编码

Body:

application/json:

NULL

1.2. 参数说明:

参数名 类型 示例 是否必填 参数含义
NULL NULL NULL NULL NULL

1.3. 正确返回:

Http Status Code:200
{
    "code": "SUCCESS",
    "message": "请求处理成功",
    "data": "{key}"
}

1.4. 状态码:

状态码 code message data 原因
200 ENTITY_NOTFOUND Key为{key}的{bosclass}实体对象不存在 NULL 当{key}的file不存在时
200 ENTITY_DELETEPERMISSION_REQUIRED 缺少实体对象{entity/key}的删除权限 NULL 当对文件无删除权限时
200 ENTITY_RELATIONSHIP_EXIST 实体对象{entity/key}存在关联关系 NULL 当delRelation值为false,且文件还存在关联关系时
200 RELATIONSHIP_RELATIONENTITY 缺少对关联实体对象{bosclass/key}的读权限 NULL 当删除关系时如果对关系中另一关联实体对象无读权限

1.5. 注意事项:

1、前提需有上传的文件。

2、当delRelation值为true时,删除文件前先删除文件所有已存在的关联实例数据。

3、delRelation如若未传默认值为false,如若参数值非法按默认值为false处理。

4、更新文件所属文档的size属性、所属文档所属所有上层文件夹的size属性。

1.6. 请求示例

请求URL

http://bosgw.bimwinner.com/bosfoundationservice/w8486e2a067e4bdab7630546ad01751a/files/239f171d42214eba9da02f8d884a3926

Headers

Authorization: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyS2V5IjoiMTUyN2ZmYWRhZjhhNGY0YWJhZTk4NWM2N2JiZDQ5NmQiLCJ1c2VyTmFtZSI6InJhb2ppYWp1biIsInVzZXJUeXBlIjoiMCIsImFwcEtleSI6InE4NWU4NTdhZWIwODQ1ZjE5YzBkY2QyYTQyNmUxMWUwIiwiYXBwTmFtZSI6InRlc3QxMTExMTEyMyIsImFwcERiIjoicTg1ZTg1N2FlYjA4NDVmMTljMGRjZDJhNDI2ZTExZTAiLCJsb2dpblRpbWUiOiIxNTk2Njk4MDAyMTA3IiwiZXhwIjowfQ.XsKFdpYnnH1lJ__u6x-4tvCnJ2BX7WfJ5EMGMAWfCe8

Body(application/json)

null

正常响应 200

{
    "message": "请求处理成功",
    "code": "SUCCESS",
    "data": "239f171d42214eba9da02f8d884a3926"
}
版权所有@盈嘉互联(北京)科技有限公司 京ICP备15051988号-9 Copyright © 2022 all right reserved,powered by Gitbook该文件修订时间: 2022-05-16 19:01:04

results matching ""

    No results matching ""