开发者接入API步骤如下，更多详情请加入： 商鹏云QQ 2群：686838578 (新群)

第一步：注册开发者账号

到 http://developer.spyun.net （以下统称‘商鹏云管理后台’）注册开发者账号。

第二步：对接API

注意:必须先调用添加打印机接口，然后才能调用打印接口进行打印。所有API接口都是https协议

第三步：测试打印

测试打印之前，请确保打印机在线，并且纸张正常。如调试打印模板有问题，请加入商鹏云开发交流QQ群

RESTful API介绍

RESTful API本质就是发送 HTTP 请求，只不过大家常用的可能是 HTTP GET 和 HTTP POST 请求，但是在 RESTful API里面还经常用到 HTTP PUT 、HTTP PACTCH、 HTTP DELETE。
在 RESTful API中，把这五种操作称之为动词，可以（但不是特别准确）想象成增删改查。客户端发送到服务端的数据类型为：application/x-www-form-urlencoded，服务器返回的数据类型为：applicstion/json，数据编码为：UTF-8。
RESTful API 接口调用成功时返回 HTTP 状态码为 200，如调用错误会返回除 200 之外的其他 HTTP 状态码，可根据返回数据中的 errorcode和errormsg 字段判断具体错误。
常见HTTP错误状态码如下：

全局errorcode如下：

添加打印机

请求url：

https://open.spyun.net/v1/printer/add

请求方法：

POST

请求数据说明：

客户端发送到服务端的数据类型为：application/x-www-form-urlencoded，服务器返回的数据类型为：applicstion/json，数据编码为：UTF-8。

请求体body：

成功返回：

{"errorcode":0}

失败返回：

  {
      "errorcode":-1,
      "errormsg":"appid为空"
  }

本接口errorcode说明：

获取打印机信息

请求url：

https://open.spyun.net/v1/printer/info

请求方法：

GET

请求数据说明：

客户端发送到服务端的数据类型为：application/x-www-form-urlencoded，服务器返回的数据类型为：applicstion/json，数据编码为：UTF-8。

请求URL参数：

成功返回：

                                    
  {
      "errorcode":0,
      "sn":"sp11222333",  // 打印机编号
      "name":"name",      // 打印机名称
      "online":1,         // 是否在线，1：在线：0：离线
      "status":0,         // 状态，0：正常，1：异常
      "sqsnum":1,         // 待打印订单数
      "model":"xxx",      // 机型
      "auto_cut":1,       // 自动切刀开关，1：开，0：关
      "voice":"U",        // 语音开关信息  N：关，Y：滴滴滴，U：小语音，V：中语音，W：大语音
      "imsi":"xxx"        // 流量卡号码,wifi机型该值为空
  }
                                    
                                

失败返回：

  {
      "errorcode":-1,
      "errormsg":"appid为空"
  }

本接口errorcode说明：

修改打印机信息

请求url：

https://open.spyun.net/v1/printer/update

请求方法：

PATCH

请求数据说明：

客户端发送到服务端的数据类型为：application/x-www-form-urlencoded，服务器返回的数据类型为：applicstion/json，数据编码为：UTF-8。

请求体body：

成功返回：

{"errorcode":0}

失败返回：

  {
      "errorcode":-1,
      "errormsg":"appid为空"
  }

本接口errorcode说明：

修改打印机配置参数

请求url：

https://open.spyun.net/v1/printer/setting

请求方法：

PATCH

请求数据说明：

客户端发送到服务端的数据类型为：application/x-www-form-urlencoded，服务器返回的数据类型为：applicstion/json，数据编码为：UTF-8。

请求体body：

成功返回：

{"errorcode":0}

失败返回：

  {
      "errorcode":-1,
      "errormsg":"appid为空"
  }

本接口errorcode说明：

删除打印机

请求url：

https://open.spyun.net/v1/printer/delete

请求方法：

DELETE

请求数据说明：

客户端发送到服务端的数据类型为：application/x-www-form-urlencoded，服务器返回的数据类型为：applicstion/json，数据编码为：UTF-8。

请求体body：

成功返回：

{"errorcode":0}

失败返回：

  {
      "errorcode":-1,
      "errormsg":"appid为空"
  }

本接口无特别errorcode。

打印订单

请求url：

https://open.spyun.net/v1/printer/print

请求方法：

POST

请求数据说明：

客户端发送到服务端的数据类型为：application/x-www-form-urlencoded，服务器返回的数据类型为：applicstion/json，数据编码为：UTF-8。

请求URL参数：

注意：发过来的打印订单会缓存12小时，超时没有打印的订单将会自动清空

排版控制标签说明：(详情请参考SDK示例)

 <BR> ：换行符
 <CUT> ：切刀指令(主动切纸,仅限切刀打印机使用才有效果) 
 <IMAGE> ：打印图片指令(前提是预先在机器内置图片,出厂时设置好)
 <L1></L1>：放大一倍
 <L2></L2>：放大两倍
 <C></C>：居中,该标签可以与DL,L,H,W嵌套
 <C><L1></L1></C>：居中放大一倍（可嵌套）
 <H></H>：字体变高一倍
 <W></W>：字体变宽一倍
 <R></R>：右对齐
 <B></B>：字体加粗
 <QRCODE></QRCODE>：二维码，单个订单只能打印一个二维码
 <BC128_A></BC128_A>：条形码（一维条码）,数字字母混合条形码,最多支持14位数字大写字母混合
 <BC128_C></BC128_C>：条形码（一维条码）,数字条形码,最多支持22位数字

 说明:来订单时默认播放新来单语音，若使用“申请退单”或“申请取消订单”的语音，请使用以下指令：
 <AUDIO-REFUND> ：申请退单语音指令。播报内容为:有用户申请退单了
 <AUDIO-CANCEL> ：申请取消订单语音指令。播报内容为:有用户申请取消订单了

成功返回：

  {
      "errorcode":0,
      "id":"5c1af88568e417349343b942",    // 打印订单ID,查询订单状态时需要用到
      "create_time":"2019-01-01 00:00:00" // 订单接收时间
  }
                                

失败返回：

  {
      "errorcode":-1,
      "errormsg":"appid为空"
  }

本接口errorcode说明：

清空待打印订单

请求url：

https://open.spyun.net/v1/printer/cleansqs

请求方法：

DELETE

请求数据说明：

客户端发送到服务端的数据类型为：application/x-www-form-urlencoded，服务器返回的数据类型为：applicstion/json，数据编码为：UTF-8。

请求URL参数：

成功返回：

  {
      "errorcode":0,       "cleannum":10  //清空的订单数
  }

失败返回：

  {
      "errorcode":-1,
      "errormsg":"appid为空"
  }

本接口errorcode说明：

查询打印订单状态

请求url：

https://open.spyun.net/v1/printer/order/status

请求方法：

GET

请求数据说明：

客户端发送到服务端的数据类型为：application/x-www-form-urlencoded，服务器返回的数据类型为：applicstion/json，数据编码为：UTF-8。

请求URL参数：

成功返回：

  {
      "errorcode":0,
      "status":true,// 打印状态，true：已打印，false：未打印 
      "print_time":"2019-01-01 00:00:00" // 打印时间
  }
                                

失败返回：

  {
      "errorcode":-1,
      "errormsg":"appid为空"
  }

本接口无特别errorcode。

查询打印机历史打印订单数

请求url：

https://open.spyun.net/v1/printer/order/number

请求方法：

GET

请求数据说明：

客户端发送到服务端的数据类型为：application/x-www-form-urlencoded，服务器返回的数据类型为：applicstion/json，数据编码为：UTF-8。

请求URL参数：

成功返回：

  {
      "errorcode":0,
      "number":18 // 已打印订单数
  }

失败返回：

  {
      "errorcode":-1,
      "errormsg":"appid为空"
  }

本接口errorcode说明：

签名生成算法

签名生成的通用步骤如下：

第一步：设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。

特别注意以下重要规则：

◆ 参数名ASCII码从小到大排序（字典序）；
◆ 如果参数的值为空不参与签名，注意为空指空字符串，"0"不为空字符串，需参与签名；
◆ 参数名区分大小写；
◆ 验证调用返回或微信主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验。

第二步：在stringA最后拼接上key得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。

举例：

假设传送的参数如下：

  {
      "appid":"sp5c1314095ed15",
      "timestamp":"1544765945",
      "sn":"111111111",
      "pkey":"22222222",
      "name":"test"
  }

第一步：对参数按照key=value的格式，并按照参数名ASCII字典序排序如下：

stringA="appid=sp5c1314095ed15&name=test&pkey=22222222&sn=111111111&timestamp=1544765873";

第二步：拼接API密钥：

stringSignTemp="stringA&appsecret=735aa25a15b75e6c1e0760823a22346a"
sign=MD5(stringSignTemp).toUpperCase()="3C24E50A3F1E0B4AB60FFA3A78E19E18"

注意：appid 和 appsecret 的值，请登陆管理后台查看开发者信息