文件新版本通知
请求说明
| 请求地址 | 回调地址 + uri(默认为:/v1/3rd/file/notify) |
|---|---|
| 请求方法 | POST |
| 签名方式 | 无 |
请求头(Header)
| 名称 | 是否必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 固定为: application/json |
| X-Weboffice-File-Id | 是 | 文件id |
| X-Wps-Weboffice-Token | 否 | 开发者通过JSSDK设置用于用户鉴权TOKEN |
查询参数(Query)
| 名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| _w_third_* | object | 否 | 合作方自定义参数, _w_third_作为前缀,_w_third_appid,_w_third_file_id 字段已被使用,对接方请合理避开 |
请求体(Body)
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| size | integer | 是 | 文件大小B(字节) |
| version | integer | 是 | 文件新版本的版本号 |
| name | string | 是 | 文件名 |
| time | integer | 是 | 当前时间戳(秒) |
请求体示例
json
{
"size": 2133,
"version": 34,
"name": "example.docx",
"time": 1637668908
}响应体(Response)
正常返回
200 OK
异常返回
| 名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| code | integer | 是 | 错误码 |
| message | string | 是 | 错误提示 |
| details | string | 是 | 错误提示详细信息 |
| hint | string | 否 | 自定义错误信息,当code为40007错误码时必填 |
异常返回示例
json
{
"code": 40005,
"message": "InvalidArgument",
"details": "参数错误",
"hint": "自定义错误提示"
}