一卡通-正元智慧

一卡通-正元智慧

专用API
【更新时间: 2024.08.14】 正元智慧一卡通服务是一款综合智能卡管理系统,为各类组织提供统一、安全的卡片管理与应用服务。通过该系统,用户可实现身份认证、支付、门禁、考勤、借阅等多功能操作,简化管理流程,提高效率。
服务星级:2星
⭐ ⭐ 🌟 🌟 🌟 🌟 🌟
调用次数
0
集成人数
0
商用人数
0
! SLA: N/A
! 响应: N/A
! 适用于个人&企业
收藏
×
完成
取消
×
书签名称
确定
<
产品介绍
>

什么是正元智慧的一卡通?

正元智慧一卡通是一种集成化的智能卡管理平台,主要用于实现校园、企业、社区等场所的统一卡片管理和应用。它通过将各种功能集成到一张智能卡中,实现了身份识别、消费支付、门禁控制、考勤管理等多种应用。正元智慧的一卡通系统不仅能够简化用户的日常操作,提高管理效率,还能通过数据分析和管理,为组织的决策提供支持。

什么是正元智慧的一卡通?

由服务使用方的应用程序发起,以Restful风格为主、通过公网HTTP协议调用正元智慧的一卡通,从而实现程序的自动化交互,提高服务效率。

正元智慧的一卡通有哪些核心功能?

智慧屏
智付终端是正元智慧自主设计的一款AI超级智能终端。它外形高端大气,内芯强大,节能高效,采用安卓7.1系统,搭载先进的人脸识别算法,提供前端离线快速精准的、识别、比对能力。
支付终端类
支付类终端主要用于学校、企事业单位餐厅、超市等收费场所,采用非接触式的IC卡、二维码、生物识别等方式实现消费功能。
门禁考勤类
门禁考勤类设备主要应用于学校、园区、企事业单位、商场、商务写字楼等场所,可采用IC卡、密码、二维码、生物识别等方式进行人员认证,实现出入口进出管控。
水控类
水控类设备主要用于公寓、浴室、开水房等用水场所。以非接触式IC卡作为电子钱包,通过对出水管电子阀门的开关控制,采用计量或计时的方式实时扣取卡中金额来实现精确计费。
一卡通配套
一卡通配套类产品主要用于配套一卡通软件进行卡片配置、充值、结算等功能。

餐厅类
餐厅类设备主要用于学校、企事业单位餐厅结算,通过手持机、AI结算台、RFID结算台等设备实现快速结算,节约人工成本。
通道类
通道类产品主要用于楼宇、政企、校园、景区及其他重要场所,采用高可靠无刷伺服机芯,高密集光幕检测,实现高度智能、安全、快速的行人出入口控制。

正元智慧的一卡通的核心优势是什么?

 

  1. 高度集成化:将多种功能集成到一张卡片中,简化了管理流程,提高了使用效率。
  2. 安全性高:采用先进的加密技术,保障用户数据和隐私的安全。
  3. 扩展性强:系统具有良好的扩展性,可以与其他管理系统无缝对接,满足不同场景的需求。
  4. 易用性强:操作界面简洁,使用方便,无需复杂的培训即可上手。
  5. 实时数据:能够实时获取和分析用户数据,帮助管理者做出更科学的决策。

 

 

在哪些场景会用到正元智慧的一卡通?

一体化餐厅

注重全链路餐厅场景业务建设,涵盖供应商管理、食材议价、食材采购、食材配送、食品安全、库存管理、成本核算、人员健康、后厨加工、餐厅结算、线上订餐、线下取餐/配送、营养分析、厨余垃圾、环境监测等环节,实现餐厅业务全闭环、对象全覆盖、体验更便捷、服务更贴心、数据更精准。

智慧校园

基础教育智慧校园解决方案应用“物联网”、“云+端”、“跨平台”、“AI智能”、“大数据”等信息化技术,重新定义校园中“识别”、“交互”、“体验”、“评价”、“管理”、“安全”等概念的外延和内涵,打造涵盖校园感知、走班教学、教务管理、学生管理、学生成长、过程评价、家校互动的智慧教育新生态。

 

智慧园区服务

以物联网、互联网、云计算、大数据等现代先进的信息技术为基础,以从智能化到平台化再到智慧化的技术提升为设计理念,以园区的管理服务转型、创新发展、生态融合等数字赋能为需求引领,以园区内信息化基础设施建设、统一数据中心形成、园区大脑搭建等为抓手实现园区运营(服务和管理)智慧化。

 

智慧易通云服务

面向多行业园区的智慧后勤服务,通过一站式智慧后勤SaaS平台+场景化建设方式,实现认证泛载化、支付无感化和服务线上化,打造园区服务新生态。

高校自助洗衣

高校自助洗衣生活解决方案,是正元智慧为满足当今高校师生对干净卫生、快速烘干、舒适环境、智能高效的高品质生活要求应运而生的运营模式。

自助洗烘升级传统洗衣模式,打造全新校园洗衣服务,在空间、设备、软件、运管、服务层面同步升级,全方位助力学校洗衣房运营管理升级。

<
使用指南
>

开始开发

注意事项

接口文档增加了接口版本号(Version),标注接口是自哪个版本起新增的。
开发者在开发时,请注意接口里的接口版本号(Version),现场一卡通程序版本大于此版本号时接口才有效。开发过程中,务必联系现场人员确认一卡通程序版本号。

获取access token

access_token是一卡通平台的全局唯一票据,一卡通平台调用各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token有失效时间,需定时刷新,重复获取将导致上次获取的access_token失效。
公众平台的API调用所需的access_token的使用及生成方式说明:

1、为了保密appsecrect,第三方需要一个access_token获取和刷新的中控(中间控制)服务器。而其他业务逻辑服务器所使用的access_token均来自于该中控服务器,不应该各自去刷新,否则会造成access_token覆盖而影响业务;
2、目前access_token的有效期通过返回的expire_in来传达,目前是7200秒之内的值,其中expire_in=0表示不失效。中控服务器需要根据这个有效时间提前去刷新新access_token。在刷新过程中,中控服务器对外输出的依然是老access_token,此时公众平台后台会保证在刷新短时间内,新老access_token都可用,这保证了第三方业务的平滑过渡;
3、access_token的有效时间可能会在未来有调整,所以中控服务器不仅需要内部定时主动刷新,还需要提供被动刷新access_token的接口,这样便于业务服务器在API调用获知access_token已超时的情况下,可以触发access_token的刷新流程。

如果第三方不使用中控服务器,而是选择各个业务逻辑点各自去刷新access_token,那么就可能会产生冲突,导致服务不稳定。
如果第三方应用存在多个业务逻辑点,这里列出几个可选方案如下:

  • 方案1:第三方有条件提供中控服务器。一卡通系统分配一套appid和appsecret给第三方,第三方在中控服务器统一获取和刷新access_token, 第三方应用的各个业务逻辑点所使用的access_token均来自于该中控服务器。
  • 方案2:第三方没有条件提供中控服务器。一卡通系统分配多套appid和appsecret给第三方(默认商户相同),第三方在各个业务逻辑点分别配置appid和appsecret(一个业务逻辑点一套)。

一卡通平台可以使用AppID和AppSecret调用本接口来获取access_token。APPID和APPSECRET可在一卡通平台相应管理人员获取。
接口调用请求说明

http请求方式: GET
URL/api/token?appid=APPID&appsecret=APPSECRET

参数说明

参数 是否必须 说明
appid 第三方用户唯一凭证
appsecret 第三方用户唯一凭证密钥

返回说明
正常情况下,一卡通平台会返回下述JSON数据包:

{access_token":"ACCESS_TOKEN","expires_in":7200}
参数 说明
access_token 获取到的凭证
expires_in 凭证有效时间,单位:秒

错误时一卡通平台会返回错误码等信息,JSON数据包示例如下(该示例为appId无效):

{"code":"40001","msg":"appId无效"}

 

详情参考链接:https://open.yktapi.com/api/

 

<
产品问答
>
?
如何获取API访问权限?
要获取API访问权限,首先需要注册一个账户。注册成功后,登录并在控制台创建一个新应用以获得API密钥。使用该密钥即可访问API。
?
API支持哪些功能?
一卡通API支持多种功能,包括余额查询、交易明细、挂失解挂、消费统计等。这些功能可以帮助开发者集成一卡通系统,提供丰富的服务。一卡通API支持多种功能,包括余额查询、交易明细、挂失解挂、消费统计等。这些功能可以帮助开发者集成一卡通系统,提供丰富的服务。
?
API请求的响应格式是什么?
API请求的响应支持JSON格式。所有返回的数据均以JSON格式提供,包含状态码和详细信息。
<
关于我们
>
正元智慧(股票代码:300645)以让科技使工作、学习、生活更智慧为使命,致力于成为国内领先的智慧校园、智慧园区整体解决方案提供商及综合服务运营商。公司自1994年创建以来,通过不断地创新技术、产品与解决方案,助力教育行业从信息化到数字化的发展变革,为数千家高校、企事业单位及数千万师生、企事业员工带来智慧体验,让智慧之美无处不在。
联系信息
服务时间: 00:00:00至24:00:00
电话号码: 0571-88994160
邮箱: sales@hzsun.com
网页在线客服: 咨询

<
最可能同场景使用的其他API
>
API接口列表
<
使用指南
>

开始开发

注意事项

接口文档增加了接口版本号(Version),标注接口是自哪个版本起新增的。
开发者在开发时,请注意接口里的接口版本号(Version),现场一卡通程序版本大于此版本号时接口才有效。开发过程中,务必联系现场人员确认一卡通程序版本号。

获取access token

access_token是一卡通平台的全局唯一票据,一卡通平台调用各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token有失效时间,需定时刷新,重复获取将导致上次获取的access_token失效。
公众平台的API调用所需的access_token的使用及生成方式说明:

1、为了保密appsecrect,第三方需要一个access_token获取和刷新的中控(中间控制)服务器。而其他业务逻辑服务器所使用的access_token均来自于该中控服务器,不应该各自去刷新,否则会造成access_token覆盖而影响业务;
2、目前access_token的有效期通过返回的expire_in来传达,目前是7200秒之内的值,其中expire_in=0表示不失效。中控服务器需要根据这个有效时间提前去刷新新access_token。在刷新过程中,中控服务器对外输出的依然是老access_token,此时公众平台后台会保证在刷新短时间内,新老access_token都可用,这保证了第三方业务的平滑过渡;
3、access_token的有效时间可能会在未来有调整,所以中控服务器不仅需要内部定时主动刷新,还需要提供被动刷新access_token的接口,这样便于业务服务器在API调用获知access_token已超时的情况下,可以触发access_token的刷新流程。

如果第三方不使用中控服务器,而是选择各个业务逻辑点各自去刷新access_token,那么就可能会产生冲突,导致服务不稳定。
如果第三方应用存在多个业务逻辑点,这里列出几个可选方案如下:

  • 方案1:第三方有条件提供中控服务器。一卡通系统分配一套appid和appsecret给第三方,第三方在中控服务器统一获取和刷新access_token, 第三方应用的各个业务逻辑点所使用的access_token均来自于该中控服务器。
  • 方案2:第三方没有条件提供中控服务器。一卡通系统分配多套appid和appsecret给第三方(默认商户相同),第三方在各个业务逻辑点分别配置appid和appsecret(一个业务逻辑点一套)。

一卡通平台可以使用AppID和AppSecret调用本接口来获取access_token。APPID和APPSECRET可在一卡通平台相应管理人员获取。
接口调用请求说明

http请求方式: GET
URL/api/token?appid=APPID&appsecret=APPSECRET

参数说明

参数 是否必须 说明
appid 第三方用户唯一凭证
appsecret 第三方用户唯一凭证密钥

返回说明
正常情况下,一卡通平台会返回下述JSON数据包:

{access_token":"ACCESS_TOKEN","expires_in":7200}
参数 说明
access_token 获取到的凭证
expires_in 凭证有效时间,单位:秒

错误时一卡通平台会返回错误码等信息,JSON数据包示例如下(该示例为appId无效):

{"code":"40001","msg":"appId无效"}

 

详情参考链接:https://open.yktapi.com/api/

 

<
依赖服务
>
<
产品问答
>
?
如何获取API访问权限?
要获取API访问权限,首先需要注册一个账户。注册成功后,登录并在控制台创建一个新应用以获得API密钥。使用该密钥即可访问API。
?
API支持哪些功能?
一卡通API支持多种功能,包括余额查询、交易明细、挂失解挂、消费统计等。这些功能可以帮助开发者集成一卡通系统,提供丰富的服务。一卡通API支持多种功能,包括余额查询、交易明细、挂失解挂、消费统计等。这些功能可以帮助开发者集成一卡通系统,提供丰富的服务。
?
API请求的响应格式是什么?
API请求的响应支持JSON格式。所有返回的数据均以JSON格式提供,包含状态码和详细信息。
<
关于我们
>
正元智慧(股票代码:300645)以让科技使工作、学习、生活更智慧为使命,致力于成为国内领先的智慧校园、智慧园区整体解决方案提供商及综合服务运营商。公司自1994年创建以来,通过不断地创新技术、产品与解决方案,助力教育行业从信息化到数字化的发展变革,为数千家高校、企事业单位及数千万师生、企事业员工带来智慧体验,让智慧之美无处不在。
联系信息
服务时间: 00:00:00至24:00:00
电话号码: 0571-88994160
邮箱: sales@hzsun.com
网页在线客服: 咨询

<
最可能同场景使用的其他API
>