二维码设计说明
以下文档说明了所有得力E+APP支持识别的各种业务场景的二维码格式。
设备绑定二维码
如果设备未绑定,应显示设备绑定二维码。得力E+APP扫描该二维码启动绑定流程。
目前支持的二维码内容格式如下:
https://delicloud.com?from=device&action=activate&product={产品型号}&device={设备ID}&status={状态}
https://delicloud.com/d/{设备ID}/activate?product={产品型号}&status={状态}
(推荐使用)
示例如下:
其中,各参数说明如下:
参数 | 是否必传 | 参数说明 |
---|---|---|
product | Y | 设备对应的产品型号 |
device | Y | 设备ID |
status | N | 设备连接状态。包括: 未联网(-1)、接入平台成功(0)、接入平台失败(1)。该字段仅对直接接入平台设备网关的设备有效 |
Web登录二维码
对于使用得力E+账户扫描登录的各个web终端,例如得力E+Web端、开发者平台等等,应在二维码登录界面显示如下二维码内容信息。
https://delicloud.com?type=web_login&sid={websocket的sid}&client_id={终端id}
示例如下:
其中,各参数说明如下:
参数 | 是否必传 | 参数说明 |
---|---|---|
sid | Y | 与平台建立的websocket通道ID |
client_id | Y | 在平台预注册的登录终端ID |
设备授权二维码
对于需要通过得力E+用户授权才能使用的设备,例如翻页笔。在设备启动时会显示如下二维码内容信息,用户通过得力E+APP扫描可完成授权登录操作,并通过指令205通知设备。
https://delicloud.com?from=device&action=login&product={产品型号}&device={设备ID}
示例如下:
其中,各参数说明如下:
参数 | 是否必传 | 参数说明 |
---|---|---|
product | Y | 设备对应的产品型号 |
device | Y | 设备的唯一ID |
应用授权二维码
对于需要通过得力E+用户授权才能使用的应用APP,例如云打印下的虚拟打印场景。在应用APP启动时会显示如下二维码信息,用户通过E+APP扫描可完成授权登录操作,并通过指令412通知应用服务。
https://delicloud.com?from=app&action=login&appid={应用ID}&sessionid={终端会话ID}
示例如下:
其中,各参数说明如下:
参数 | 是否必传 | 参数说明 |
---|---|---|
appid | Y | 应用在平台注册的唯一ID |
sessionid | Y | 应用当前进行授权登录的终端会话ID,用于唯一表示一个APP终端会话。 |
应用访问二维码
对于设备特定的业务场景,得力E+支持通过扫描设备应用二维码的方式,自动跳转并将自定义二维码参数传递到设备首屏,用于满足设备的某些快捷操作。
目前支持的二维码内容格式如下:
https://delicloud.com/d/{设备ID}/appcall?key1=value1&key2=value2&...
示例如下:
其中,链接中可以自定义任意数量的key
和value
,app扫描识别该二维码后,会自动跳转到设备首屏,并完整传递该二维码信息到设备应用界面。
对于某些特殊应用场景,应用无法按照规定的格式生成上述二维码信息时,也可以通过自定义扫码注册504注册自定义的应用二维码信息。
组织邀请二维码
对于某些需要将人员加入到组织的业务场景,应用可以生成组织邀请码并邀请E+注册用户通过扫描该二维码的方式加入到指定组织。
目前支持的二维码内容格式如下:
https://delicloud.com/org_invitation?token={令牌}&org_id={组织ID}&org_name={组织名称}
&admin_id={管理员ID}&admin_name={管理员名称}
示例如下:
其中,各参数说明如下:
参数 | 是否必传 | 参数说明 |
---|---|---|
token | Y | 通过授权令牌指令510获得的token |
org_id | Y | 授权的组织ID |
org_name | Y | 授权的组织名称 |
admin_id | Y | 授权邀请加入组织的管理员ID |
admin_name | Y | 授权邀请加入组织的管理员的名称 |
组织成员激活二维码
待补充