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