差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
im:server:basics:fileoperation [2019/06/14 09:09] jk [下载缩略图] |
im:server:basics:fileoperation [2022/05/19 04:11] (当前版本) jennifer.zeng |
||
---|---|---|---|
行 1: | 行 1: | ||
====== 文件上传下载 ====== | ====== 文件上传下载 ====== | ||
+ | |||
+ | 更新时间:2021-12-31 该文档已不再维护,请看新版 3.X 文档。 | ||
+ | |||
+ | 新版文档地址:[[ccim:rest:message|消息管理]] | ||
---- | ---- | ||
行 9: | 行 13: | ||
* 如果选择限制的话,会在上传请求完成后返回一个 secret,只有知道这个 secret,并且是 APP 的注册用户,才能够下载文件。 | * 如果选择限制的话,会在上传请求完成后返回一个 secret,只有知道这个 secret,并且是 APP 的注册用户,才能够下载文件。 | ||
* 如果选择不限制的话,则只要是 APP 的注册用户就能够下载。 | * 如果选择不限制的话,则只要是 APP 的注册用户就能够下载。 | ||
+ | * 如选择加secert限制的话,''消息回调(包含发送前回调和发送后回调)、历史消息这些功能中涉及下载文件时,都需要在下载url中拼接secert,才能正常下载文件''; | ||
+ | * 拼接规则如下: | ||
+ | <code json> | ||
+ | {{url}}?share-secret={{secret}} | ||
+ | </code> | ||
+ | | ||
---- | ---- | ||
行 93: | 行 103: | ||
=====下载语音/图片文件===== | =====下载语音/图片文件===== | ||
这里需要注意的就是,需要在 HTTP header 中带上上面返回的 share-secret 和当前登录用户的 token 才能够下载,同时注意 header 中执行的 accept 的值需要设置成 application/octet-stream。 | 这里需要注意的就是,需要在 HTTP header 中带上上面返回的 share-secret 和当前登录用户的 token 才能够下载,同时注意 header 中执行的 accept 的值需要设置成 application/octet-stream。 | ||
+ | |||
+ | uuid 和 share-secret 在文件上传成功后会返回。 | ||
=== HTTP Request === | === HTTP Request === | ||
- | ^{{:im:server:basics:get.png?nolink&90|}}^**/{org_name}/{app_name}/chatfiles/{filestream}**^ | + | ^{{:im:server:basics:get.png?nolink&90|}}^**/{org_name}/{app_name}/chatfiles/{uuid}**^ |
- | 需要在请求时对应填写{filestream},需要获取文件返回的 uuid 和 share-secret。 | + | |
=== Request Headers === | === Request Headers === | ||
行 103: | 行 115: | ||
|Content-Type|application/json| | |Content-Type|application/json| | ||
|Authorization|Bearer ${token}| | |Authorization|Bearer ${token}| | ||
+ | |share-secret|share-secret| | ||
=== 请求示例 === | === 请求示例 === |