钉工牌功能-Demo
钉工牌简介
钉工牌是企业数字化的标志,是员工的数字化工作证。钉钉基于组织自身的通讯录,联合支付宝和阿里云的支付与安全能力,为企业组织提供一站式的工牌解决方案。
企业可开通钉工牌服务,员工出示钉工牌,不仅能实现物理工牌常有的门禁通行、食堂就餐支付等能力,还能有访客识别、企业协议价支付、员工收款等能力。钉钉聚焦实现用户端钉工牌的展码、解码、支付、安全等能力,在应用场景上与合作伙伴的系统开放共建。
接入准备
-
成为钉钉开发者,详情请参考成为钉钉开发者。
-
根据需求创建对应的应用,详情请参考应用类型介绍。
-
应用创建完成后,根据自身场景添加相应的接口调用权限。
- 企业内部应用和第三方企业应用
-
登录开发者后台,单击进入应用详情页。
-
单击权限管理,然后搜索钉工牌对应的接口权限,单击申请权限。
- 纯ISV身份应用
-
登录开发者后台,单击进入应用详情页。
-
单击权限管理,然后搜索付款码对应的接口权限,单击申请权限。
-
获取接口调用凭证,如何获取不同应用的凭证请参考访问凭证概述。
-
根据不同的使用场景,调用钉工牌相关接口。
- 门禁核验场景
- 临时会展场景
- 刷码消费场景
运行准备
下载本项目至本地
git clone https://github.com/open-dingtalk/dingtalkfinance-demo.git
脚本启动(推荐)
脚本说明
脚本中内置了内网穿透工具,不需要再额外启动
dingBoot-linux.sh # linux版本
dingBoot-mac.sh # mac版本
dingBoot-windows.bat # windows版本
启动命令
执行时将其中参数替换为对应的应用参数,在backend目录下执行(脚本同级目录),参数获取方法:
- 获取corpId——开发者后台首页:https://open-dev.dingtalk.com/#/index
- 进入应用开发-企业内部开发-点击进入应用-基础信息-获取appKey、appSecret、agentId
- 启动linux脚本
./dingBoot-linux.sh start {项目名} {端口号} {appKey} {appSecret} {agentId} {corpId}
- mac系统(mac m1芯片暂不支持)
./dingBoot-mac.sh start {项目名} {端口号} {appKey} {appSecret} {agentId} {corpId}
- windows系统 使用cmd命令行启动
./dingBoot-windows.bat {项目名} {端口号} {appKey} {appSecret} {agentId} {corpId}
- 示例(linux脚本执行)
./dingBoot-linux.sh start h5-demo 8080 ding1jmkwa4o19bxxxx ua2qNVhleIx14ld6xgoZqtg84EE94sbizRvCimfXrIqYCeyj7b8QvqYxxx 122549400 ding9f50b15bccd1000
启动后配置
- 配置地址
启动完成会自动生成临时域名,配置方法:进入开发者后台->进入应用->开发管理->应用首页地址和PC端首页地址
- 发布应用
配置好地址后进入“版本管理与发布页面”,发布应用,发布后即可在PC钉钉或移动钉钉工作台访问应用
手动启动
获取相应参数
获取到以下参数,修改application.properties文件内容
dingtalk.app_key=xxx
dingtalk.app_secret=xxx
dingtalk.suite_key=xxx
dingtalk.suite_secret=xxx
dingtalk.suite_ticket=xxx
接口说明
demo依赖链路图
此处展示企业内部应用的开发方式
修改前端页面
打开项目,命令行中执行以下命令,编译打包生成build文件
cd front-end
npm install
npm run build
将打包好的静态资源文件放入后端
启动项目
- 启动SpringBoot
- 移动端钉钉点击工作台,找到创建的应用,进入应用
效果展示
操作列表
配置钉工牌
创建钉工牌
钉工牌入口
扫描钉工牌获取码值
钉工牌解码
解码获取付款码
同步支付结果/同步退款结果
支付/退款信息
验证钉工牌电子码身份