應用接入開放平臺需要獲取用戶的隱私數據(如賬號、打印機、訂單等),為保證商戶數據的安全與隱私,應用需要取得商戶的授權,即獲取訪問商戶數據的授權令牌 Access Token。因此,應用需要引導用戶完成使用易聯云帳號“登錄授權”的流程。該流程采用國際通用的OAuth2.0標準協議作為用戶身份驗證與授權協議。
如果使用用戶賬號登錄開放平臺且創建的自有應用服務模式,請使用OAuth2.0的客戶端授權模式。
如果注冊了服務商賬號,創建了開放應用服務模式,需要使用OAuth2.0的授權碼模式引導商戶授權。
客戶端授權模式流程
(A)開發者的客戶端應用向認證服務器發起HTTP POST請求進行身份認證,并要求一個訪問令牌。
(B)認證服務器確認無誤后,向應用提供訪問令牌。
授權碼授權模式流程
企業類型的應用的開發是指企業獨立完成應用的設計開發后,作為商品服務推廣給商戶使用。
(A)商戶訪問客戶端應用,后者將前者導向開放平臺認證服務器。
(B)商戶自行選擇是否給予應用授權。
(C)假設商戶給予授權,認證服務器將商戶導向客戶端事先指定的"重定向URI"(redirection URI),同時附上一個授權碼code。
(D)客戶端收到授權碼,使用授權碼向認證服務器申請訪問令牌。這一步是在客戶端的后臺服務器上完成的,對商戶不可見。
(E)認證服務器核對了授權碼和重定向URI,確認無誤后,向客戶端發送訪問令牌(access_token)和更新令牌(refresh_token)。
(F)假設商戶拒絕授權,認證服務器將商戶導向客戶端事先指定的"重定向URI"(redirection URI),同時附上error信息
(G)在access_token即將過期之前,可以使用refresh_token直接向認證服務器發起請求,換取新的access_token,延續access_token的有效期
- 平臺簡介
- 概念和術語
- 新手指南
- 開發文檔
- 接入API服務指南
- API調用協議說明
- 開放應用服務模式
- 自有應用服務模式
- 掃描二維碼授權模式
- 消息推送協議說明
- API文檔列表
- 文本打印接口
- 圖形打印接口
- 面單打印接口
- 設置內置語音接口
- 刪除內置語音接口
- 刪除終端授權
- 添加應用菜單
- 關機重啟接口
- 聲音調節接口
- 獲取機型打印寬度接口
- 獲取機型軟硬件版本接口
- 取消所有未打印訂單接口
- 取消單條未打印訂單接口
- 設置logo接口
- 取消logo接口
- 打印方式接口
- 接單拒單設置接口
- 設置推送url接口
- 獲取訂單狀態接口
- 獲取訂單列表接口
- 獲取終端狀態接口
- 推送接口
- 簽名規則
- 打印完成推送
- 接單拒單推送
- 按鍵請求推送
- 應用菜單推送
- 打印機實時狀態推送
- 打印機指令
- K7-GHC/K7-WHC排版指令
- K4-GH(新固件)/K4-WH(新固件)排版指令
- K6-WH(新固件)排版指令
- M1-G(新固件)排版指令
- W1(新固件)排版指令
- K5(新固件)排版指令
- K2S、K3S、M1排版指令
- K7、K6、K5、K4排版指令
- X1排版指令
- W1排版指令
- Ai語音播報指令
- 指令詳解
- 二維碼打印
- 條碼打印
- 打印多聯
- 字體加大
- 字體加粗
- 字體加高
- 字體加寬
- 換行
- 居中對齊
- 左右對齊
- 右對齊
- 一行三格或四格對齊排版
- 制表符
- 自定義來單提醒
- 自定義來單聲音控制
- 訂單確認
- SDK使用說明
- 注意事項
- 全局返回碼
- 獲取終端號和特殊密鑰