本文主要记录自己在工作学习中遇到的坑和解决思路，仅供大家参考

目录

前言

一、钉盘是什么？

二、为什么要使用钉盘？

三、JSAPI鉴权

1.鉴权的时机

2.鉴权的时效

3.鉴权的代码

3.1.获取access_token

3.2.获取jsapi_ticket

3.3.计算签名参数

3.4.引入JS

3.5.JSAPI鉴权

四、钉盘空间

1.添加空间

2.空间授权

五、上传和预览

1.上传

2.预览

六、问题与解决

1.问题

2.解决思路

七、总结

       在工作中，经常会被要求提供附件的上传、下载和预览等功能，上传和下载实现起来较为简单，但是预览功能在尝试过多种实现方式后都不尽如人意。此时想到了网上是否有现成的第三方程序可以直接使用，鉴于一些不可描述的原因（就是领导不舍得花钱，就是抠~~~），最终选定了免费的钉钉云盘来实现预览功能。以下是我在实现过程中的一些心得和遇到的问题及其解决方式。

        钉盘，顾名思义，就是钉钉自带的云盘，可以给注册企业开辟免费100G云空间（想扩容得加钱）用于文件的存储。

        钉钉提供了很多自带的API给广大的开发者，而调用这些API则可以实现我们的需求（主要原因还是免费）。

        钉钉不管后端提供了各种API，前端也提供了大量的JSAPI供大家使用，比如我们即将使用的上传和预览，都是前端可以直接用JS调用，但是由于不同客户端的区分，部分JSAPI需要在使用之前先要鉴权（比如钉钉的获取登录用户信息就不用鉴权，上传和预览则需要），具体哪些JSAPI需要鉴权可参考：https://open.dingtalk.com/document/isvapp/jsapi-overview

       鉴权的方式有很多种，这里我介绍一种我这次使用的鉴权方式

         上面我们说了为什么要鉴权，但为什么鉴权还有时机呢？那是因为鉴权是针对某一个页面URL的，比如我们新增页面要用到上传功能，这时候我们需要在用上传的JSAPI前先对当前新增页面进行鉴权，成功后才能在新增页面使用上传的JSAPI。那么问题来了，我一个应用有N个需要用到此类JSAPI的页面，那每个页面都需要单独做鉴权吗？那岂不是很麻烦？

        参考钉钉的开发者文档，加和钉钉开发人员你的沟通后，总结出鉴权只要在主页面鉴权一次，后续路由变动不影响鉴权的有效性。什么意思呢？举个例子，我通过登录页进入到首页后，只要在首页初始化时鉴权一次（比如对url:http://xxx.xxx.xxx.xxx:8080/index鉴权），后面通过变动路由实现跳转的页面将全部都有鉴权效果。

        鉴权一次后，是不是只要URL不变，鉴权是不是一直都有效呢？当然不是，当你关闭浏览器后重新通过浏览器登录系统后，需要重新鉴权，所以建议在登录时跟着登录的方法或进入首页时，调用鉴权。

        根据创建的H5微应用的AppKey和AppSecret获取，基操，做过钉钉应用开发的应该都会，新人可以参考：https://open.dingtalk.com/document/orgapp/obtain-orgapp-token#

        调用钉钉API获取jsapi_ticket，jsapi_ticket有2小时的时效性（不要在意这些，因为我们获取后马上就会用上，不可能会给他过期的机会）

        参数说明：

                jsticket：通过3.2获取；

                nonceStr：自定义标识，可以随意取；

                timeStamp：时间戳，一般用当前时间即可，需要注意的是需要保存下来，后面一起传递到前端使用，前后端的时间戳要保持一致

                url：需要鉴权的URL，上面提到的首页地址即可

        前端引入JS

        获取上面获取的鉴权信息，填入后即可鉴权成功。

        通过第三步的一顿操作我们终于把最复杂（恶心,yue~~~）的鉴权准备工作做好了，后续我们就可以调用上传和预览的JSAPI了，但在此之前，我们需要指定一个空间用来存放上传的附件，这里我们就需要在钉盘上添加一个特定的空间（可以理解为是一个文件夹），用于存储文件。

        这个比较简单，话不多说，直接上代码。

         注意：新创建的空间是无法通过客户端（比如手机钉钉或钉钉PC端）看到的，可以理解为创建的文件夹是不可见的，但确实真实存在的。正好用于我们保存上传的附件，因为我们只是想让用户可以把附件上传上来，后续不能通过客户端查看。

        新创建的空间对于所有普通用户（非管理员）是没有权限操作的，企业的员工还无法上传和预览，我们需要对企业员工授权。

        参数说明：

                members.type：授权对象类型，ORG为企业；DEPT为部门；USER为用户，常用这仨

                members.id：ORG对应企业corpId，DEPT对应部门deptId，USER对应用户unionId

                roleId：OWNER为拥有者，MANAGER为管理者，EDITOR为编辑者，DOWNLOADER为下载者，READER为查看者，权限按顺利从高至低，没人只能保有一个roleId，即给用户添加了高级权限后，再添加低级权限也没用，反之则高权限覆盖低权限。如需要从高权限降至低权限则需要调用修改权限的API，参考：https://open.dingtalk.com/document/orgapp/modify-storage-permissions

        OK，准备工作已经就绪，现在就可以上传和预览了，直接上代码

        参数说明：

                compress：是否压缩，默认true

                spaceId：上面创建的空间ID

                folderId：空间中存放附件的文件夹ID，没有可以不传

                types：上传的方式

        参数说明：都很好理解，友情提醒fileSize和fileType可以不填，不影响预览

        到这里是不是小伙伴们觉得已经完成了？我只能说你们还是太年轻了，下面我将我遇到的问题和解决思路分享出来，有更好的解决方法可以分享出来讨论。

        为了每个用户都要可以上传附件，所以我们将会给每个企业用户设置钉盘空间的权限为EDITOR。那么问题来了，有了编辑者的权限后，所有用户都可以对空间内的附件进行修改，毕竟领导可不希望上传到服务器的附件今天显示的报销金额是1000，明天就变成了10000。这时候就会有小伙伴说了，不是新建的空间是客户端不可见的吗，我看不到我肯定也改不了啊。但事你们忽略了一个问题，我们还有预览功能。

        预览里面居然可以编辑，而且问过钉钉开发人员后得知还不能隐藏，为什么就不能在预览的JSAPI调用参数里添加一个参数来控制是否允许在预览时进行修改呢？当我知道无法通过代码层面来解决这个问题时，我的内心是崩溃的，连我这么菜的人都能想到的需求为啥钉钉开发人员没有想到。

        崩溃归崩溃，但还是要实现甲方爸爸的需求（毕竟关系到了我的口袋）。既然钉钉无法实现我们的需求，我们就要换一个思路。经过翻开了大量钉钉API后我找到了一种办法：

        现在的问题是，预览只需要用户有READER或者DOWNLOADER权限即可，可以用户能上传，就必须要有EDITOR的权限，那么我们是否可以将两者分开呢？基于这个思路，我将原来的A空间不变，还是赋予员工EDITOR权限。然后新增B钉盘空间，赋予员工DOWNLOADER权限。在用户上传附件至A空间后，立即触发移动文件的API，将刚上传的附件从A空间移动到B空间。之后就简单了，前端的预览功能统一访问B空间的文件。这样就做到了权限分离，上传和预览分开，顺利解决。上代码：

        参数说明：

                option.conflictStrategy：

                        auto_rename：自动重命名，默认值

                        overwrite：覆盖

                        return_dentry_if_exists：返回已存在

                        return_error_if_exists：报错

                unionId：操作人的unionId，需要注意的是由于目标空间普通用户没有编辑权限，这里需要写死管理员的unionId

        至此顺利完成功能，虽然其中的原理不难，都是调用钉钉现成的API，但当第三方无法实现自身的需求时，变通思路是非常有必要的，特此记录作为学习笔记。如大家有更好的解决方式望留言分享。