 |
一卡通-正元智慧
專用API
【更新時間: 2024.08.14】
正元智慧一卡通服務(wù)是一款綜合智能卡管理系統(tǒng)，為各類組織提供統(tǒng)一、安全的卡片管理與應(yīng)用服務(wù)。通過該系統(tǒng)，用戶可實現(xiàn)身份認(rèn)證、支付、門禁、考勤、借閱等多功能操作，簡化管理流程，提高效率。
|
瀏覽次數(shù)
156
采購人數(shù)
2
試用次數(shù)
0
SLA: N/A
響應(yīng): N/A
適用于個人&企業(yè)
收藏
×
完成
取消
×
書簽名稱
確定
|
- API詳情
- 使用指南
- 常見 FAQ
- 關(guān)于我們
- 相關(guān)推薦
什么是正元智慧的一卡通?
正元智慧一卡通是一種集成化的智能卡管理平臺，主要用于實現(xiàn)校園、企業(yè)、社區(qū)等場所的統(tǒng)一卡片管理和應(yīng)用。它通過將各種功能集成到一張智能卡中，實現(xiàn)了身份識別、消費支付、門禁控制、考勤管理等多種應(yīng)用。正元智慧的一卡通系統(tǒng)不僅能夠簡化用戶的日常操作，提高管理效率，還能通過數(shù)據(jù)分析和管理，為組織的決策提供支持。
什么是正元智慧的一卡通接口？
正元智慧的一卡通有哪些核心功能？
| 智慧屏 智付終端是正元智慧自主設(shè)計的一款A(yù)I超級智能終端。它外形高端大氣，內(nèi)芯強大，節(jié)能高效，采用安卓7.1系統(tǒng)，搭載先進的人臉識別算法，提供前端離線快速精準(zhǔn)的、識別、比對能力。 |
 |
 |
支付終端類 支付類終端主要用于學(xué)校、企事業(yè)單位餐廳、超市等收費場所，采用非接觸式的IC卡、二維碼、生物識別等方式實現(xiàn)消費功能。 |
| 門禁考勤類 門禁考勤類設(shè)備主要應(yīng)用于學(xué)校、園區(qū)、企事業(yè)單位、商場、商務(wù)寫字樓等場所，可采用IC卡、密碼、二維碼、生物識別等方式進行人員認(rèn)證，實現(xiàn)出入口進出管控。 |
 |
 |
水控類 水控類設(shè)備主要用于公寓、浴室、開水房等用水場所。以非接觸式IC卡作為電子錢包，通過對出水管電子閥門的開關(guān)控制，采用計量或計時的方式實時扣取卡中金額來實現(xiàn)精確計費。 |
| 一卡通配套 一卡通配套類產(chǎn)品主要用于配套一卡通軟件進行卡片配置、充值、結(jié)算等功能。 |
 |
 |
餐廳類 餐廳類設(shè)備主要用于學(xué)校、企事業(yè)單位餐廳結(jié)算，通過手持機、AI結(jié)算臺、RFID結(jié)算臺等設(shè)備實現(xiàn)快速結(jié)算，節(jié)約人工成本。 |
| 通道類 通道類產(chǎn)品主要用于樓宇、政企、校園、景區(qū)及其他重要場所，采用高可靠無刷伺服機芯，高密集光幕檢測，實現(xiàn)高度智能、安全、快速的行人出入口控制。 |
 |
正元智慧的一卡通的核心優(yōu)勢是什么？
- 高度集成化：將多種功能集成到一張卡片中，簡化了管理流程，提高了使用效率。
- 安全性高：采用先進的加密技術(shù)，保障用戶數(shù)據(jù)和隱私的安全。
- 擴展性強：系統(tǒng)具有良好的擴展性，可以與其他管理系統(tǒng)無縫對接，滿足不同場景的需求。
- 易用性強：操作界面簡潔，使用方便，無需復(fù)雜的培訓(xùn)即可上手。
- 實時數(shù)據(jù)：能夠?qū)崟r獲取和分析用戶數(shù)據(jù)，幫助管理者做出更科學(xué)的決策。
在哪些場景會用到正元智慧的一卡通？
|
一體化餐廳 注重全鏈路餐廳場景業(yè)務(wù)建設(shè)，涵蓋供應(yīng)商管理、食材議價、食材采購、食材配送、食品安全、庫存管理、成本核算、人員健康、后廚加工、餐廳結(jié)算、線上訂餐、線下取餐/配送、營養(yǎng)分析、廚余垃圾、環(huán)境監(jiān)測等環(huán)節(jié)，實現(xiàn)餐廳業(yè)務(wù)全閉環(huán)、對象全覆蓋、體驗更便捷、服務(wù)更貼心、數(shù)據(jù)更精準(zhǔn)。 |
|
|
智慧校園 基礎(chǔ)教育智慧校園解決方案應(yīng)用“物聯(lián)網(wǎng)”、“云+端”、“跨平臺”、“AI智能”、“大數(shù)據(jù)”等信息化技術(shù)，重新定義校園中“識別”、“交互”、“體驗”、“評價”、“管理”、“安全”等概念的外延和內(nèi)涵，打造涵蓋校園感知、走班教學(xué)、教務(wù)管理、學(xué)生管理、學(xué)生成長、過程評價、家校互動的智慧教育新生態(tài)。 |
|
|
智慧園區(qū)服務(wù) 以物聯(lián)網(wǎng)、互聯(lián)網(wǎng)、云計算、大數(shù)據(jù)等現(xiàn)代先進的信息技術(shù)為基礎(chǔ)，以從智能化到平臺化再到智慧化的技術(shù)提升為設(shè)計理念，以園區(qū)的管理服務(wù)轉(zhuǎn)型、創(chuàng)新發(fā)展、生態(tài)融合等數(shù)字賦能為需求引領(lǐng)，以園區(qū)內(nèi)信息化基礎(chǔ)設(shè)施建設(shè)、統(tǒng)一數(shù)據(jù)中心形成、園區(qū)大腦搭建等為抓手實現(xiàn)園區(qū)運營（服務(wù)和管理）智慧化。 |
|
|
智慧易通云服務(wù) 面向多行業(yè)園區(qū)的智慧后勤服務(wù)，通過一站式智慧后勤SaaS平臺+場景化建設(shè)方式，實現(xiàn)認(rèn)證泛載化、支付無感化和服務(wù)線上化，打造園區(qū)服務(wù)新生態(tài)。 |
|
|
高校自助洗衣 高校自助洗衣生活解決方案，是正元智慧為滿足當(dāng)今高校師生對干凈衛(wèi)生、快速烘干、舒適環(huán)境、智能高效的高品質(zhì)生活要求應(yīng)運而生的運營模式。 自助洗烘升級傳統(tǒng)洗衣模式，打造全新校園洗衣服務(wù)，在空間、設(shè)備、軟件、運管、服務(wù)層面同步升級，全方位助力學(xué)校洗衣房運營管理升級。 |
|
開始開發(fā)
注意事項
接口文檔增加了接口版本號（Version），標(biāo)注接口是自哪個版本起新增的。
開發(fā)者在開發(fā)時，請注意接口里的接口版本號（Version），現(xiàn)場一卡通程序版本大于此版本號時接口才有效。開發(fā)過程中，務(wù)必聯(lián)系現(xiàn)場人員確認(rèn)一卡通程序版本號。
獲取access token
access_token是一卡通平臺的全局唯一票據(jù)，一卡通平臺調(diào)用各接口時都需使用access_token。開發(fā)者需要進行妥善保存。access_token的存儲至少要保留512個字符空間。access_token有失效時間，需定時刷新，重復(fù)獲取將導(dǎo)致上次獲取的access_token失效。
公眾平臺的API調(diào)用所需的access_token的使用及生成方式說明：
1、為了保密appsecrect，第三方需要一個access_token獲取和刷新的中控（中間控制）服務(wù)器。而其他業(yè)務(wù)邏輯服務(wù)器所使用的access_token均來自于該中控服務(wù)器，不應(yīng)該各自去刷新，否則會造成access_token覆蓋而影響業(yè)務(wù)；
2、目前access_token的有效期通過返回的expire_in來傳達，目前是7200秒之內(nèi)的值，其中expire_in=0表示不失效。中控服務(wù)器需要根據(jù)這個有效時間提前去刷新新access_token。在刷新過程中，中控服務(wù)器對外輸出的依然是老access_token，此時公眾平臺后臺會保證在刷新短時間內(nèi)，新老access_token都可用，這保證了第三方業(yè)務(wù)的平滑過渡；
3、access_token的有效時間可能會在未來有調(diào)整，所以中控服務(wù)器不僅需要內(nèi)部定時主動刷新，還需要提供被動刷新access_token的接口，這樣便于業(yè)務(wù)服務(wù)器在API調(diào)用獲知access_token已超時的情況下，可以觸發(fā)access_token的刷新流程。
如果第三方不使用中控服務(wù)器，而是選擇各個業(yè)務(wù)邏輯點各自去刷新access_token，那么就可能會產(chǎn)生沖突，導(dǎo)致服務(wù)不穩(wěn)定。
如果第三方應(yīng)用存在多個業(yè)務(wù)邏輯點，這里列出幾個可選方案如下：
- 方案1：第三方有條件提供中控服務(wù)器。一卡通系統(tǒng)分配一套appid和appsecret給第三方，第三方在中控服務(wù)器統(tǒng)一獲取和刷新access_token， 第三方應(yīng)用的各個業(yè)務(wù)邏輯點所使用的access_token均來自于該中控服務(wù)器。
- 方案2：第三方?jīng)]有條件提供中控服務(wù)器。一卡通系統(tǒng)分配多套appid和appsecret給第三方（默認(rèn)商戶相同），第三方在各個業(yè)務(wù)邏輯點分別配置appid和appsecret（一個業(yè)務(wù)邏輯點一套）。
一卡通平臺可以使用AppID和AppSecret調(diào)用本接口來獲取access_token。APPID和APPSECRET可在一卡通平臺相應(yīng)管理人員獲取。
接口調(diào)用請求說明
http請求方式: GET
URL/api/token?appid=APPID&appsecret=APPSECRET
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
|---|---|---|
| appid | 是 | 第三方用戶唯一憑證 |
| appsecret | 是 | 第三方用戶唯一憑證密鑰 |
返回說明
正常情況下，一卡通平臺會返回下述JSON數(shù)據(jù)包：
{access_token":"ACCESS_TOKEN","expires_in":7200}
| 參數(shù) | 說明 |
|---|---|
| access_token | 獲取到的憑證 |
| expires_in | 憑證有效時間，單位：秒 |
錯誤時一卡通平臺會返回錯誤碼等信息，JSON數(shù)據(jù)包示例如下（該示例為appId無效）:
{"code":"40001","msg":"appId無效"}
詳情參考鏈接：https://open.yktapi.com/api/
開始開發(fā)
注意事項
接口文檔增加了接口版本號（Version），標(biāo)注接口是自哪個版本起新增的。
開發(fā)者在開發(fā)時，請注意接口里的接口版本號（Version），現(xiàn)場一卡通程序版本大于此版本號時接口才有效。開發(fā)過程中，務(wù)必聯(lián)系現(xiàn)場人員確認(rèn)一卡通程序版本號。
獲取access token
access_token是一卡通平臺的全局唯一票據(jù)，一卡通平臺調(diào)用各接口時都需使用access_token。開發(fā)者需要進行妥善保存。access_token的存儲至少要保留512個字符空間。access_token有失效時間，需定時刷新，重復(fù)獲取將導(dǎo)致上次獲取的access_token失效。
公眾平臺的API調(diào)用所需的access_token的使用及生成方式說明：
1、為了保密appsecrect，第三方需要一個access_token獲取和刷新的中控（中間控制）服務(wù)器。而其他業(yè)務(wù)邏輯服務(wù)器所使用的access_token均來自于該中控服務(wù)器，不應(yīng)該各自去刷新，否則會造成access_token覆蓋而影響業(yè)務(wù)；
2、目前access_token的有效期通過返回的expire_in來傳達，目前是7200秒之內(nèi)的值，其中expire_in=0表示不失效。中控服務(wù)器需要根據(jù)這個有效時間提前去刷新新access_token。在刷新過程中，中控服務(wù)器對外輸出的依然是老access_token，此時公眾平臺后臺會保證在刷新短時間內(nèi)，新老access_token都可用，這保證了第三方業(yè)務(wù)的平滑過渡；
3、access_token的有效時間可能會在未來有調(diào)整，所以中控服務(wù)器不僅需要內(nèi)部定時主動刷新，還需要提供被動刷新access_token的接口，這樣便于業(yè)務(wù)服務(wù)器在API調(diào)用獲知access_token已超時的情況下，可以觸發(fā)access_token的刷新流程。
如果第三方不使用中控服務(wù)器，而是選擇各個業(yè)務(wù)邏輯點各自去刷新access_token，那么就可能會產(chǎn)生沖突，導(dǎo)致服務(wù)不穩(wěn)定。
如果第三方應(yīng)用存在多個業(yè)務(wù)邏輯點，這里列出幾個可選方案如下：
- 方案1：第三方有條件提供中控服務(wù)器。一卡通系統(tǒng)分配一套appid和appsecret給第三方，第三方在中控服務(wù)器統(tǒng)一獲取和刷新access_token， 第三方應(yīng)用的各個業(yè)務(wù)邏輯點所使用的access_token均來自于該中控服務(wù)器。
- 方案2：第三方?jīng)]有條件提供中控服務(wù)器。一卡通系統(tǒng)分配多套appid和appsecret給第三方（默認(rèn)商戶相同），第三方在各個業(yè)務(wù)邏輯點分別配置appid和appsecret（一個業(yè)務(wù)邏輯點一套）。
一卡通平臺可以使用AppID和AppSecret調(diào)用本接口來獲取access_token。APPID和APPSECRET可在一卡通平臺相應(yīng)管理人員獲取。
接口調(diào)用請求說明
http請求方式: GET
URL/api/token?appid=APPID&appsecret=APPSECRET
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
|---|---|---|
| appid | 是 | 第三方用戶唯一憑證 |
| appsecret | 是 | 第三方用戶唯一憑證密鑰 |
返回說明
正常情況下，一卡通平臺會返回下述JSON數(shù)據(jù)包：
{access_token":"ACCESS_TOKEN","expires_in":7200}
| 參數(shù) | 說明 |
|---|---|
| access_token | 獲取到的憑證 |
| expires_in | 憑證有效時間，單位：秒 |
錯誤時一卡通平臺會返回錯誤碼等信息，JSON數(shù)據(jù)包示例如下（該示例為appId無效）:
{"code":"40001","msg":"appId無效"}
詳情參考鏈接：https://open.yktapi.com/api/
