教你一招 美达罗捷云打印机的对接API方法
1、首先要在美达罗捷开放平台注册开发者账号,获得密钥APPKEY,注册地址是:http://api.bjguntong.com/medlogic/login.html,获得密钥后,使用开发者工具将 mobilePhone + apiKey + timestamp 拼接成字符串,然后进行MD5加密。apiKey为商户首次申请注册后由美达罗捷提供的开发者密钥,用来进行API调用。加密后获得的32位字符串就是sign(签名)。
2、然后是添加打印机: POST /printer/add
功能描述:
在系统中添加打印机。
添加规则:
拿到打印机后可获得打印机mac,使用mac作为打印机唯一标识对打印机进行注册。添加注册后,打印机接入系统,可以进行打印。
传入参数:
字段名
说明
是否必填
mobilePhone申请AppKey时注册的联系人手机号是
timestamp当前时间戳,以ms为单位是
sign签名(注)是
type打印机类型:1:wifi打印机;3:4G(gprs)打印机;5:二合一打印机。默认为1。是
wifiSn打印机的wifi网卡序列号否
gprsSn打印机的4G(gprs)网卡序列号否
name打印机名称是
返回参数:
字段名
类型
说明
codeInteger返回代码。成功:200。其他是失败。
dataObject返回内容
macSnString生成的打印机mac序列号
successboolean是否成功。成功:true,失败:false。
msgString返回消息
3、打印订单内容: POST /order/print
功能描述:
通过格式设定,编辑打印内容,通过打印机进行打印。打印可以设置打印语言为中文或外文,支持多语言打印。可以设置打印订单份数,支持批量打印。对于语音打印机,在每次打印时,会播报语音“您有新的订单”。
传入参数:
字段名
说明
是否必填
mobilePhone申请AppKey时注册的联系人手机号是
timestamp当前时间戳,以ms为单位是
sign签名(注)是
macSn打印机的mac序列号是
content经过排版后的打印内容(字符串)(注)是
language打印的语言选择(1:中文;2:外文。默认不填该选项,就是中文)否
copy打印份数(默认不填就是1份)否
打印排版格式说明:
<Content></Content> : 内容根节点,所有打印内容必须包含在<Content>内;
<BR></BR>: 新起一行。每行内容需包含在<BR>内;
<CB></CB>: 居中放大;
<B></B>:字体放大;
<C></C>:居中;
<L></L>:字体变高;
<W></W>:字体变宽;
<RIGHT></RIGHT>:右对齐;
<BOLD></BOLD>:字体加粗;
<QRCODE></QRCODE>:打印二维码;
<CODE128></CODE128>:打印条形码;(采用Code128编码)
打印内容示例:
String test = "<content>";
test += "<BR>这是一个测试</BR>";
test += "<BR>中间有字<BOLD>变粗</BOLD>正常</BR>";
test += "<BR>这行<CB>是</CB>纯文<RIGHT>字</RIGHT></BR>";
test += "<BR>这行既要<B>变高又变宽</B>,看看效果</BR>";
test += “<QRCODE>abcdefghijklmn</QRCODE>”;
test += "</content>";
注意:以下是系统保留字符,如需要在内容中使用,请替换成其他合法字符。
<小于号
>大于号
&和号
'单引号
"双引号
返回参数:
字段名
类型
说明
codeInteger返回代码。成功:200。其他是失败。
dataString订单ID号
successboolean是否成功。成功:true,失败:false。
msgString返回消息
4、取消订单内容: POST /order/cancelPrint
功能描述:
打印客户的取消订单内容
打印规则:
打印取消订单的内容编辑规则与订单打印相同。不同之处在于,对于语音打印机,在每次打印时,会播报语音“您有订单被取消了”。
传入参数:
字段名
说明
是否必填
mobilePhone申请AppKey时注册的联系人手机号是
timestamp当前时间戳,以ms为单位是
sign签名(注)是
macSn打印机的mac序列号是
content经过排版后的打印内容(字符串)(注)是
language打印的语言选择(1:中文;2:外文。默认不填该选项,就是中文)否
返回参数:
字段名
类型
说明
codeInteger返回代码。成功:200。其他是失败。
dataString订单ID号
successboolean是否成功。成功:true,失败:false。
msgString返回消息
5、获取打印机状态: GET /printer/status
功能描述:
获取打印机当前状态
状态描述:
打印机连上系统后,可能在线,或者关机。根据打印机类型,分为WIFI打印机、4G打印机、二合一打印机,可以返回每一块网卡的是否在线状态。
传入参数:
字段名
说明
是否必填
mobilePhone申请AppKey时注册的联系人手机号是
timestamp当前时间戳,以ms为单位是
sign签名(注)是
macSn打印机的mac序列号是
返回参数:
字段名
类型
说明
codeInteger返回代码。成功:200。其他是失败。
dataString返回视图类
statusInteger打印机状态(注)
statusTextString打印机状态文字说明
successboolean是否成功。成功:true,失败:false。
msgString返回消息
注:Status说明:
数字代表状态信息:0:打印机离线; 1:打印机wifi在线; 3:打印机gprs(4G)在线;5:打印机wifi 和 gprs(4G)都在线;
6、功能描述:
获取该商户下所有打印机当前状态。
方法说明:
对于在系统中注册的商户(开发者),可以批量获得名下所有连接的打印机,获取打印机状态。
传入参数:
字段名
说明
是否必填
mobilePhone申请AppKey时注册的联系人手机号是
timestamp当前时间戳,以ms为单位是
sign签名(注)是
返回参数:
字段名
类型
说明
codeInteger返回代码。成功:200。其他是失败。
dataArray打印机数组
macSnString打印机的macSn
statusInteger打印机状态(注)
statusTextString打印机状态文字说明
successboolean是否成功。成功:true,失败:false。
msgString返回消息
注:Status说明:
数字代表状态信息:0:打印机离线; 1:打印机wifi在线; 3:打印机gprs(4G)在线;5:打印机wifi 和 gprs(4G)都在线;
7、删除打印机: POST /printer/delete
功能描述:
从系统中删除指定打印机。
方法说明:
使用macSn,删除对应的打印机。删除打印机后,打印机从系统中清除。
传入参数:
字段名
说明
是否必填
mobilePhone申请AppKey时注册的联系人手机号是
timestamp当前时间戳,以ms为单位是
sign签名(注)是
macSn打印机的mac序列号是
返回参数:
字段名
类型
说明
codeInteger返回代码。成功:200。其他是失败。
dataObject返回内容
successboolean是否成功。成功:true,失败:false。
msgString返回消息
8、当操作完成后,美达罗捷云打印机的配网方法我再共享一个操作视频,将美达罗捷云打印机和本地的WiFi配网即可,配网后,将打印机的SN码也就是自检页上的MAC码录取后即可实现云打印打印了,来订单自动接单,自动打印啦,以上就是美达罗捷API开放平台给您的教程啦,如果您是技术开发者会看明白,假如还是看不懂,那就要问下美达罗捷官方了