接入形式
一、企业微应用
企业微应用的定位就是企业内部自己使用,企业微应用对创建套件无强制要求,只需要提供可用的
二、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 | 操作时间 |