终端状态查询接口

易联云API集成查询终端 易联云API支持查询已部署易联云打印机（终端）的实时工作状态。当易联云API收到一个查询打印机设备状态的请求时，将检查一遍调用方所拥有的所有易联云打印机，并返回一段状态信息和对应的状态码。 注；此接口是主动查询接口，易联云也有提供推送上报接口，详情查看终端状态上报接口文档

API接口地址（查询终端状态的端点）

地址：http://open.10ss.net:8888/getstatus.php

端口：8888

API调用方法

易联云API请求以及参数应该用 POST 方法发送。易联云API将根据收到的信息验证请求的有效性反馈对应的状态码。

必填参数和需要提交的参数

发送查询数据到易联云请求必须包含以下参数：

系统级输入参数
名称 类型 是否提交 是否必填 描述 示例值
partner int 是 是 用户id（管理中心系统集成里默取）
sign String 是 是 API输入签名结果（生成的参数）
machine_code String 是 是 打印机终端号
mkey String 否 是 打印机终端密钥
apikey String 否 是 apikey（管理中心系统集成里默取） -
举例：
partner=6 //用户ID
apikey=d17d7d6cdaaa77a6dba928b6553c665325a033d5 //API密钥
machine_code=613 //打印机终端号
mkey=123456 //打印机密钥
sign=A25DA41E0CE84D06CA754BEA7C458BE8 //生成的签名加密

签名加密算法如下：

Sign= apikey+（machine_code+partner）+mkey 串在一起后进行MD5加密然后再转换成大写 //括号里面的参数是需要名和值的，apikey和mkey只需要值

从以上举例中得到的加密参数：

d17d7d6cdaaa77a6dba928b6553c665325a033d5machine_code613partner6123456

（黄色底为名，红色底为值） 这是未加密前串在一起的排列，然后把这串字符进行MD5加密得到的结果就是sign的值

需要传递给API的参数是：

partner、machine_code、sign //这3个参数是需要提交给API端点的

举例提交内容如下

machine_code=613&partner=6&sign=A25DA41E0CE84D06CA754BEA7C458BE8

返回的状态码

易联云API的查询请求的返回值说明：

  • status:0 离线
  • status:1 在线
  • status:2 缺纸

results matching ""

    No results matching ""