二维码设计说明

以下文档说明了所有得力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}

示例如下:

web登录二维码

其中,各参数说明如下:

参数 是否必传 参数说明
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&...

示例如下:

应用访问二维码

其中,链接中可以自定义任意数量的keyvalue,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 授权邀请加入组织的管理员的名称

组织成员激活二维码

待补充