钉钉ISV接入总结

    2016年09月21日 doc php 字数:2084

接入形式

一、企业微应用

企业微应用的定位就是企业内部自己使用,企业微应用对创建套件无强制要求,只需要提供可用的

二、ISV微应用

独立软件开发商,所开发出的套件不仅仅局限于本企业内部,可以通过扫码形式提供给授权的企业。

ISV微应用上架流程

图片

钉钉ISV授权流程

图片

涉及到的钉钉授权请求

请求功能 请求地址 请求参数 请求响应
获取套件的suite_access_token /get_suite_token suite_key、suite_secret、suite_ticket suite_access_token
获取企业的永久授权码 /get_permanent_code suite_access_toke、tmp_auth_code permanent_code
获取企业的corp_access_token /get_corp_token suite_access_token、permanent_code、auth_corpid corp_access_token
激活企业中的套件 /activate_suite suite_access_token、permanent_code、suite_key、auth_corpid
获取企业的基本信息 /get_auth_info suite_access_token、permanent_code、suite_key、auth_corpid 企业基本信息,包括套件中的各应用在这个企业的
获取企业中本套件中的具体应用的状态 /get_agent suite_access_token、perment_code、suite_key、auth_corpid、agentid 应用信息,包括是否“激活”的状态

独立开发商与钉钉对接示意图

图片

底层存储

一、企业

属性名称 属性数据类型 备注说明
corp_id   企业ID
corp_name   企业名称
suite_id   套件ID
agent_id   应用ID
auth_corp_info   企业授权信息
access_token   企业access_token
permanent_code   永久授权码
tmp_auth_code   企业临时授权码
create_time   企业激活时间点
expire_time   token过期时间

二、用户信息可以不做存储,只在下载时做下载记录即可。

记录corpid、userid、username、docid

三、套件

属性名称 属性数据类型 备注说明
suite_id   套件id
suite_name   套件名称
suite_key   套件key-固定值
suite_secret   套件密钥-固定值
suite_ticket   套件ticket-钉钉端定时推送
suite_access_token   套件access_token-时效性
update_time   更新时间点

四、应用

五、操作记录

属性名称 属性数据类型 备注说明
corp_id   企业ID
op_type   操作类型 激活、增加授权、取消授权
op_time   操作时间