电子货架接口
关于我们电子货架标签接口的描述
对象
- 供应商中立
- 一些接口支持所有显示/网络连接技术
- 接口可以被应用于基站(推荐)或者服务器上
- 接口不是RSJ指定的,可以使用不同的标签软件
- 多供应商(一个商店内)
- 只需定义另一个基站
- 可选择的在同一个店内使用多标签方案(使用同一个基站)
- 中立的技术
- 自我描述标签(功能)
- 功能可以被用于标签生成(如根据标签尺寸选择标签格式)
- 可扩展
- 状态块中的新的域(新的功能)
- 轻松的安装
- 无需软件在服务器上(如果有基站则应用接口)
- 最小的调试设置
- 只需定义基站和绑定
- 轻松的测试
- 可以从任何一个网站浏览器的简单页面时进行测试
- 考虑到的包括在基站上的一个纯html的测试页面
- 通过VPN或OAuth2安全使用
- 适应于不同的网络场景
- 可远程控制(对于小型安装) *适用于不同的布置选项
- 轻视的运用
- 只需2个简单的HTTP REST 控件(+可选的OAuth2)
HTTP 重置接口
GET http://basestation/<barcodeOnLabel>
会返回一个JSON状态块
{
status: “OK”, // 状态
battery: 100, // 电量 以百分比
signalStrength: 80, // 信号强度 以百分比
xSize: 192, // x尺寸 以像素
ySize: 100, // (y尺寸)in pixel(以像素)
colorMode: “BW”, // 颜色模式) "BW" or “GRAY” or “RGB”
levels: 1 // 等级显示等级 (defaults to 1)
}
注意: 我们可能会为标签发送给不属于这个基站的GET请求(因为我们可能各每个商店配置了不止一个基站,且我们不知道这个标签应该从哪个基站开始)并且如果在这个基站中没有找到我们会得到一个如HTTP 404的反馈。
POST http://basestation/<barcodeOnLabel>
| 参数名称 | 类别 | 描述 | | --- | --- | --- | --- | | bitmap | 文档 | 图片 .PNG file with Bitmap |
这个请求会返回一个上述的JSON状态块。
如果标签有不止一层级别,我们将会将其归类为非默认级别,通过
POST http://basestation/<barcodeOnLabel>/<level>
HTTP 状态代码
| 状态 | 描述 |
|---|---|
| 403 | 需要重新授权认证OAuth2 |
| 404 | 没有发现标签 |
这个接口使得标签和基站测试变得极其简单(甚至对于非程序员)。您只需要一个网页浏览器
如果需要授权认证,我们建议使用OAuth2(和https)。
当需要得到发送频道的全部宽带时我们可以发送平行请求(只需要告诉我们多少)
如果您有不同的界面是,我们将不得不编制为我们的接口编制一个上述的调制器。
