添加终端接口

添加终端接口是为了第三方用户方便自动添加打印机到云端。 当用户在第三方业务系统里添加打印设备时，将自动添加在易联云第三方客户的账号里。去除了第三方手动添加的麻烦。

易联云API支持接口添加易联云打印机（终端）到云打印中心。当易联云API收到一个添加打印机设备的请求时，就将指定的终端号添加到云打印中心，并返回对应添加状态。

API接口地址（添加终端的端点）

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

端口：8888

API调用方法

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

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

名称 类型 是否提交 是否必填 描述
partner int 是 是 用户id（管理中心系统集成里默取）
machine_code String 是 是 打印机终端号
msign String 是 是 打印机终端密钥
apikey String 是 是 apikey（管理中心系统集成里默取）
mobilephone String 是 是 终端内部的手机号（方便充值）
username String 是 是 用户名（登录管理中心用是用户名）
printname String 是 是 打印机终端名称（自定义）
sign String 是 是 API输入签名结果（生成的参数）

举例：

$partner=6                                        //用户ID
$apikey=d17d7d6cdaaa77a6dba928b6553c665325a033d5  //API密钥
$machine_code=613                                 //打印机终端号
$msign=123456                                     //打印机密钥
$username=qiancongbin                             //用户名
$mobilephone=15982424080                          //打印机内的手机号
$printname=天府广场店                             //打印机名称
$sign= 76498F196F82FC5F0CDA8A3B9F67B660           //生成的32位签名加密
签名加密算法如下：

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

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

d17d7d6cdaaa77a6dba928b6553c665325a033d5partner6machine_code613usernameqiancongbinprintname天府广场店mobilephone15982424080msign123456123456

这是未加密前串在一起的排列，然后把这串字符进行MD5加密得到的结果就是sign的值

需要传递给API的参数是：

Partner、machine_code、username、printname、mobilephone、msign、sign

//这7个参数是需要提交给API端点的

举例提交内容如下;

partner=6&machine_code=613&username=qiancongbin&printname=天府广场店&mobilephone=15982424080&msign=123456&sign=76498F196F82FC5F0CDA8A3B9F67B660

partner=4849&machine_code=4004510816&username=wohugb&printname=91%E6%8B%BC%E5%9B%A2&mobilephone=&msign=yczjtspmzxix&sign=271D7CD0AD2D175FC2BF8A7E94A7339C

返回的状态码

  1. 添加成功
  2. 重复
  3. 添加失败
  4. 添加失败
  5. 用户验证失败
  6. 非法终端号

results matching ""

    No results matching ""