Coder Social home page Coder Social logo

dingtalkfinance-demo's Introduction

钉工牌功能-Demo

钉工牌简介

钉工牌是企业数字化的标志,是员工的数字化工作证。钉钉基于组织自身的通讯录,联合支付宝和阿里云的支付与安全能力,为企业组织提供一站式的工牌解决方案。

企业可开通钉工牌服务,员工出示钉工牌,不仅能实现物理工牌常有的门禁通行、食堂就餐支付等能力,还能有访客识别、企业协议价支付、员工收款等能力。钉钉聚焦实现用户端钉工牌的展码、解码、支付、安全等能力,在应用场景上与合作伙伴的系统开放共建。

接入准备

  1. 成为钉钉开发者,详情请参考成为钉钉开发者

  2. 根据需求创建对应的应用,详情请参考应用类型介绍

  3. 应用创建完成后,根据自身场景添加相应的接口调用权限。

    • 企业内部应用和第三方企业应用
    1. 登录开发者后台,单击进入应用详情页

    2. 单击权限管理,然后搜索钉工牌对应的接口权限,单击申请权限

    • 纯ISV身份应用
    1. 登录开发者后台,单击进入应用详情页。

    2. 单击权限管理,然后搜索付款码对应的接口权限,单击申请权限

  4. 获取接口调用凭证,如何获取不同应用的凭证请参考访问凭证概述

    • 企业内部应用和第三方企业应用,获取AccessToken进行接口调用,请参考

    • 纯ISV身份应用,获取SuiteAccessToken进行接口调用,请参考

  5. 根据不同的使用场景,调用钉工牌相关接口。

    • 门禁核验场景
    • 临时会展场景
    • 刷码消费场景

运行准备

下载本项目至本地

git clone https://github.com/open-dingtalk/dingtalkfinance-demo.git

脚本启动(推荐)

脚本说明

脚本中内置了内网穿透工具,不需要再额外启动

dingBoot-linux.sh     # linux版本
dingBoot-mac.sh       # mac版本
dingBoot-windows.bat  # windows版本

启动命令

执行时将其中参数替换为对应的应用参数,在backend目录下执行(脚本同级目录),参数获取方法:

  1. 获取corpId——开发者后台首页:https://open-dev.dingtalk.com/#/index
  2. 进入应用开发-企业内部开发-点击进入应用-基础信息-获取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

启动后配置

  1. 配置地址

启动完成会自动生成临时域名,配置方法:进入开发者后台->进入应用->开发管理->应用首页地址和PC端首页地址

  1. 发布应用

配置好地址后进入“版本管理与发布页面”,发布应用,发布后即可在PC钉钉或移动钉钉工作台访问应用

手动启动

获取相应参数

获取到以下参数,修改application.properties文件内容

  • 三方企业登陆开发者后台获取企业内部应用app_key、app_secret image1
  • 纯ISV企业登陆开发者后台获取三方应用suite_key、suite_secret、suite_ticket
dingtalk.app_key=xxx
dingtalk.app_secret=xxx

dingtalk.suite_key=xxx
dingtalk.suite_secret=xxx
dingtalk.suite_ticket=xxx

接口说明

demo依赖链路图

image333

此处展示企业内部应用的开发方式

image2

修改前端页面

打开项目,命令行中执行以下命令,编译打包生成build文件

cd front-end
npm install
npm run build

将打包好的静态资源文件放入后端

image-20210706173224172

启动项目

  • 启动SpringBoot
  • 移动端钉钉点击工作台,找到创建的应用,进入应用

效果展示

操作列表

配置钉工牌

22

创建钉工牌

33

钉工牌入口

44

扫描钉工牌获取码值

00

钉工牌解码

55

解码获取付款码

88

同步支付结果/同步退款结果

66

支付/退款信息

99

验证钉工牌电子码身份

77

参考文档

  1. 钉工牌简介:https://developers.dingtalk.com/document/app/introduction-to-dingtalk-badge
  2. 如何调用钉工牌API:https://developers.dingtalk.com/document/app/application-for-dingtalk-badge-permission

dingtalkfinance-demo's People

Contributors

nannanness avatar specialall avatar wanzhiqiang avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.