# 打印接口 ***** 本节介绍易联云API最重要的功能，发送数据到易联云API并通过易联云打印机输出打印，以及对应的返回状态码。 ## API接口地址（发送打印数据的端点） 地址：http://open.10ss.net:8888 端口：8888 请求方式：POST ## API调用方法 发送打印数据到易联云API请求以及参数应该用POST方法发送。易联云API将根据收到的信息验证请求的有效性反馈对应的状态码。 ## 必填参数和需要提交的参数 发送打印数据到易联云请求必须包含以下参数 （系统参数和应用参数） 系统级输入参数 |名称| 类型| 是否提交 |是否必填 |描述| |-|-| -|-|-| |apikey |String |否| 是| apikey（管理中心系统集成里获取）| |machine_code| String |是 |是| 打印机终端号| |msign |String| 否 |是 |打印机终端密钥| |partner| int| 是| 是 |用户id（管理中心系统集成里获取）| |time |int |是 |是 |当前10位数的时间戳（服务器用于验证超时）| |sign |String |是| 是| API输入签名结果（生成的参数）| 应用级输入参数 |名称 |类型| 是否提交| 是否必填 |描述| |-|-|-|-|-| |content| String| 是| 是| urlencode编码后的打印的内容数据| ## 举例： ~~~ $partner = 6 //用户ID $apikey=d17d7d6cdaaa77a6dba928b6553c665325a033d5 //API密钥 $machine_code=613 //打印机终端号 $msign=123456 //打印机密钥 $time=1427647569 //当前时间戳 $content=%e6%b5%8b%e8%af%95%e6%89%93%e5%8d%b0 //打印内容 $sign=E764D4463ABC82EAA98738012887B5AC //生成的32位签名 ~~~ ## 签名加密算法如下： sign=apikey+(machine_code+partner+time)+msign 串在一起后进行MD5加密然后再转换成大写，括号里面的参数是需要名和值的，apikey和msign只需要值 ## 从以上举例中得到的加密参数： d17d7d6cdaaa77a6dba928b6553c665325a033d5machine_code613partner6time1427647569123456 这是未加密前串在一起的排列，然后把这串字符进行MD5加密得到的结果就是sign的值 ## 需要传递给API的参数是： partner、machine_code、content、time、sign //这5个参数是需要提交给API端点的 ## 举例提交内容如下: partner=6&machine_code=613&time=1427647569&sign=E764D4463ABC82EAA98738012887B5AC&content=%e6%b5%8b%e8%af%95%e6%89%93%e5%8d%b0 ## 返回JSON数据的状态码 |状态码|说明| |-|-| |state:"1","id":"1234" |数据提交成功，1234代表单号，打印完成上报时用、详情请查看：[打印完成自动上报接口文档]()| |state:"2"| 提交时间超时。验证你所提交的时间戳超过3分钟后拒绝接受| |state:"3"| 参数有误| |state:"4"| sign加密验证失败| 特殊验证码 |验证码|说明| |-|-| |{-1.1, "The partner can not be empty, The partner received by the server is '{}'"}|用户id不能为空| |{-1.2, "The partner must be a number, The partner received by the server is '{2sz}'"}|用户id必须为数字| |{-1.3, "The machine_code can not be empty, The machine_code received by the server is '{}'"}|打印机不能为空| ## 注意事项 1、content字段需要进行urlencode编码，否则可能无法正常提交 :-: <a target="_blank" href="//shang.qq.com/wpa/qunwpa?idkey=761f845b409a5483b96e91f26de0d23fef9ca67e214c1eb75ab503e6c07a0107"><img border="0" src="//pub.idqqimg.com/wpa/images/group.png" alt="易联云对接开发支持" title="易联云对接开发支持"></a>