附件上传
接收附件流和附件基本信息,返回附件ID。
请求格式说明
请求方式:POST (HTTPS)
请求地址:
https://open.welink.huaweicloud.com/api/knowledge/v1/file/upload
认证方式: access_token,请参考获取access_token
请求头部:
Accept-Charset:UTF-8
Content-Type:multipart/form-data
x-wlk-Authorization:access_token
lang:zh
请求参数:
corpUserId=123456&name=示例文档.doc
请求参数说明:
参数 | 参数类型 | 必填 | 说明 |
---|---|---|---|
corpUserId | String | 特殊可选 | 作者在客户系统的登录标示,客户内唯一。corpUserId、userId不可同时为空,都存在时优先使用corpUserId |
userId | String | 特殊可选 | 作者在WeLink中的用户账号【可在用户管理看到类似 xx@tenant 】。corpUserId、userId不可同时为空,都存在时优先使用corpUserId |
name | String | 是 | 附件完整名,包含后缀。 |
file | File | 是 | 附件文件流,附件最大为20M |
请求示例:
curl -X POST \
'https://open.welink.huaweicloud.com/api/knowledge/v1/file/upload' \
-H 'Accept-Charset: UTF-8' \
-H 'x-wlk-Authorization: access_token' \
-F 'file=@a.xls' \
-F 'corpUserId=123456&name=示例文档.doc'
响应格式说明
返回结果:
正常返回结果:
{
"code": "0",
"message": "success",
"data": {
"fileId": "12"
}
}
异常返回结果:
{
"code": "43011",
"message": "参数错误!"
}
返回参数说明:
参数 | 必选 | 参数类型 | 说明 |
---|---|---|---|
code | 是 | String | 数据正常返回“0”,如果发生错误,会返回对应的错误码。 |
message | 否 | String | 返回接口请求发生错误时的详细信息。正常情况无此信息 |
data | 否 | Object | 成功返回的数据 |
data.fileId | 是 | Array | 上传成功文件的文件ID |
错误码说明:
错误码 | 说明 |
---|---|
0 | 成功 |
43021 | 认证异常 |
43011 | 参数错误 |
43012 | 操作失败 |
43051 | 用户异常:用户不存在 |
43999 | 系统错误 |