教你一招 美达罗捷云打印机的对接API方法

2025-11-07 19:25:36

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开放平台给您的教程啦,如果您是技术开发者会看明白,假如还是看不懂,那就要问下美达罗捷官方了

声明:本网站引用、摘录或转载内容仅供网站访问者交流或参考,不代表本站立场,如存在版权或非法内容,请联系站长删除,联系邮箱:site.kefu@qq.com。
猜你喜欢