删除终端接口
删除终端接口是为了第三方用户方便自动删除。 当用户在第三方业务系统里删除打印设备时,将自动在易联云第三方客户的账号里同时删除,去除了第三方手动删除的麻烦。
易联云API支持接口到云打印中心删除易联云打印机(终端),当易联云API收到一个删除打印机设备的请求时,就将到云打印中心删除指定的终端号,并返回对应删除状态。
API接口地址(删除终端的端点)
地址:http://open.10ss.net:8888/removeprint.php
端口:8888
API调用方法
易联云API请求以及参数应该用POST方法发送。易联云API将根据收到的信息验证请求的有效性反馈对应的状态码。
必填参数和需要提交的参数:
名称 | 类型 | 是否提交 | 是否必填 | 描述 |
---|---|---|---|---|
partner | int | 是 | 是 | 用户id(管理中心系统集成里默取) |
machine_code | String | 是 | 是 | 打印机终端号 |
sign | String | 是 | 是 | API输入签名结果(生成的参数) |
举例:
$partner=6 //用户ID
$apikey=d17d7d6cdaaa77a6dba928b6553c665325a033d5 //API密钥
$machine_code=613 //打印机终端号
$msign=123456 //打印机密钥
$sign= 76498F196F82FC5F0CDA8A3B9F67B660 //生成的32位签名加密
签名加密算法如下:
Sign= apikey+(machine_code + partner )+msign 串在一起后进行MD5加密然后再转换成大写,括号里面的参数是需要名和值的,apikey和msign只需要值
从以上举例中得到的加密参数:
d17d7d6cdaaa77a6dba928b6553c665325a033d5 machine_code613partner6123456
这是未加密前串在一起的排列,然后把这串字符进行MD5加密得到的结果就是sign的值
需要传递给API的参数是:
Partner、machine_code、sign //这3个参数是需要提交给API端点的
举例提交内容如下:
partner=6&machine_code=613&sign=76498F196F82FC5F0CDA8A3B9F67B660
返回的状态码:
- 删除成功
- 没这个设备
- 删除失败
- 认证失败