# 添加应用菜单接口 **** 应用菜单添加接口是为了方便第三方平台添加应用菜单。 当用户在第三方业务系统里添加应用菜单时，将自动添加在易联云客户的相应的打印机里。去除了第三方手动添加的麻烦。 易联云API支持添加易联云打印机（终端）应用菜单到云打印中心。当易联云API收到一个添加打印机设应用菜单的请求时，就将指定的应用菜单添加到云打印中心对应的打印机里，并返回对应添加状态。 ### 针对机型 目前支持K4 ### 您需填写3个栏目 菜单名称：对此功能的文字解释（18个字节以内）； 推送地址：实现功能对接的推送地址。 ### 示例： 菜单名称：美团外卖关店 推送地址：http://waimai.meituan.com/push_url ### API接口地址（添加终端的端点） 地址：http://open.10ss.net:8888/addprintmenu.php 端口：8888 请求方式：POST ### API调用方法 易联云API请求以及参数应该用POST方法发送。易联云API将根据收到的信息验证请求的有效性反馈对应的状态码。 ###必填参数和需要提交的参数 |名称| 类型 |是否提交| 是否必填| 描述| |-|-|-|-|-| |apikey| String |否| 是| apikey（管理中心系统集成里获取）| |partner| int| 是 |是| 用户id（管理中心系统集成里获取）| |machine_code| String| 是 |是| 打印机终端号| |msign |String |否 |是 |打印机终端密钥| |time |String |是 |是 |当前时间戳| |sign |String| 是| 是| API输入签名结果（生成的参数）| ### 应用级输入参数 |名称| 类型| 是否提交| 是否必填| 描述| |-|-|-|-|-| |printmenu |String| 是| 是 |json格式的应用菜单（其中url和菜单名称需要urlencode)| ### 举例 ~~~ $partner=626 //用户ID $apikey=8c61ff8e4d1b6ed9930f6cb21029f67df630f92a //API密钥 $machine_code=521 //打印机终端号 $msign=111111 //打印机密钥 $time=1481338057 //当前时间戳 $printmenu=["菜单名称","http://www.10ss.net/uel?id=1"] //应用菜单内容 $sign=6CD5D530678824ECFEB0F975EAC52ABF //生成的32位签名 ~~~ ### 签名加密算法如下： sign= apikey+（machine_code+partner + time）+msign 串在一起后进行MD5加密然后再转换成大写，括号里面的参数是需要名和值的，apikey和msign只需要值 ### 从以上举例中得到的加密参数： 8c61ff8e4d1b6ed9930f6cb21029f67df630f92amachine_code521partner626time1481338057111111 这是未加密前串在一起的排列，然后把这串字符进行MD5加密转成大写得到的结果就是sign的值 ### 需要传递给API的参数是： partner、machine_code、printmenu、time、sign 这5个参数是需要提交给API端点的 ### 举例提交内容如下: partner=626&machine_code=521&time=1481338057&sign=6CD5D530678824ECFEB0F975EAC52ABF&printmenu=["%E8%8F%9C%E5%8D%95%E5%90%8D%E7%A7%B0","http%3A%2F%2Fwww.10ss.net%2Fuel%3Fid%3D1"] ### 返回的状态码 * {"state":400, "msg":"应用菜单已设置成功"} * {"state":401, "msg":"签名错误"} * {"state":402, "msg":"参数不全"} * {"state":403, "msg":"应用菜单数量不允许超过九个"} * {"state":404, "msg":"应用菜单名称重复"} * {"state":405, "msg":"应用菜单发送到打印机失败"} * {"state":406, "msg":"添加失败，请稍候重试"} * {"state":407, "msg":"终端号未绑定"} * {"state":408, "msg":"应用菜单格式不正确"} * {"state":409, "msg":"应用菜单名称不正确"} * {"state":410, "msg":"应用菜单url不正确"} * {"state":411, "msg":"提交时间超时"} ### 注意事项 1、打印机必须在线，否则应用菜单将不能发送到打印机，应用菜单无效 ### 关于应用菜单的设置 1、登录易联云后台 2、点击左侧终端管理进入打印机管理 3、选择K4打印机，点击进入控制台 4、在打印机设置界面的右下方点击查看应用菜单 :-: <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>