![]() |
一卡通-正元智慧
专用API
【更新时间: 2024.08.14】
正元智慧一卡通服务是一款综合智能卡管理系统,为各类组织提供统一、安全的卡片管理与应用服务。通过该系统,用户可实现身份认证、支付、门禁、考勤、借阅等多功能操作,简化管理流程,提高效率。
咨询
去服务商官网采购>
|
服务星级:2星
浏览次数
134
采购人数
2
试用次数
0
收藏
×
完成
取消
×
书签名称
确定
|
- API详情
- 使用指南
- 常见 FAQ
- 关于我们
- 相关推荐


什么是正元智慧的一卡通?
正元智慧一卡通是一种集成化的智能卡管理平台,主要用于实现校园、企业、社区等场所的统一卡片管理和应用。它通过将各种功能集成到一张智能卡中,实现了身份识别、消费支付、门禁控制、考勤管理等多种应用。正元智慧的一卡通系统不仅能够简化用户的日常操作,提高管理效率,还能通过数据分析和管理,为组织的决策提供支持。
什么是正元智慧的一卡通接口?
正元智慧的一卡通有哪些核心功能?
智慧屏 智付终端是正元智慧自主设计的一款AI超级智能终端。它外形高端大气,内芯强大,节能高效,采用安卓7.1系统,搭载先进的人脸识别算法,提供前端离线快速精准的、识别、比对能力。 |
![]() |
![]() |
支付终端类 支付类终端主要用于学校、企事业单位餐厅、超市等收费场所,采用非接触式的IC卡、二维码、生物识别等方式实现消费功能。 |
门禁考勤类 门禁考勤类设备主要应用于学校、园区、企事业单位、商场、商务写字楼等场所,可采用IC卡、密码、二维码、生物识别等方式进行人员认证,实现出入口进出管控。 |
![]() |
![]() |
水控类 水控类设备主要用于公寓、浴室、开水房等用水场所。以非接触式IC卡作为电子钱包,通过对出水管电子阀门的开关控制,采用计量或计时的方式实时扣取卡中金额来实现精确计费。 |
一卡通配套 一卡通配套类产品主要用于配套一卡通软件进行卡片配置、充值、结算等功能。 |
![]() |
![]() |
餐厅类 餐厅类设备主要用于学校、企事业单位餐厅结算,通过手持机、AI结算台、RFID结算台等设备实现快速结算,节约人工成本。 |
通道类 通道类产品主要用于楼宇、政企、校园、景区及其他重要场所,采用高可靠无刷伺服机芯,高密集光幕检测,实现高度智能、安全、快速的行人出入口控制。 |
![]() |
正元智慧的一卡通的核心优势是什么?
- 高度集成化:将多种功能集成到一张卡片中,简化了管理流程,提高了使用效率。
- 安全性高:采用先进的加密技术,保障用户数据和隐私的安全。
- 扩展性强:系统具有良好的扩展性,可以与其他管理系统无缝对接,满足不同场景的需求。
- 易用性强:操作界面简洁,使用方便,无需复杂的培训即可上手。
- 实时数据:能够实时获取和分析用户数据,帮助管理者做出更科学的决策。
在哪些场景会用到正元智慧的一卡通?
一体化餐厅 注重全链路餐厅场景业务建设,涵盖供应商管理、食材议价、食材采购、食材配送、食品安全、库存管理、成本核算、人员健康、后厨加工、餐厅结算、线上订餐、线下取餐/配送、营养分析、厨余垃圾、环境监测等环节,实现餐厅业务全闭环、对象全覆盖、体验更便捷、服务更贴心、数据更精准。 |
|
智慧校园 基础教育智慧校园解决方案应用“物联网”、“云+端”、“跨平台”、“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/






开始开发
注意事项
接口文档增加了接口版本号(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/





