 |
一卡通-正元智慧
專用API
【更新時間: 2024.08.14】
正元智慧一卡通服務是一款綜合智能卡管理系統，為各類組織提供統一、安全的卡片管理與應用服務。通過該系統，用戶可實現身份認證、支付、門禁、考勤、借閱等多功能操作，簡化管理流程，提高效率。
咨詢
去服務商官網采購>
|
瀏覽次數
156
采購人數
2
試用次數
0
SLA: N/A
響應: N/A
適用于個人&企業
收藏
×
完成
取消
×
書簽名稱
確定
|
- 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/
