易联云热敏⼩票打印机(K4-WH)接⼊指南
易联云热敏⼩票打印机提供了丰富的接⼝和⽅便的开放平台。这⾥对于 K4-WH 型号(WIFI 版)的接⼊流程进⾏了总结。
K4-WH(WA)接⼊ WIFI ⽅法
易联云云打印开发⽂档
概念和术语
名词释义
⾃有应⽤服务模式:如果您是个⼈/个体商户/企业,为⾃⼰管理的云打印机做开发,创建的应⽤即为⾃有应⽤服务模式,只能授权给开发者本⼈账号使⽤。
开放应⽤服务模式:指企业独⽴完成应⽤的设计开发后,作为商品服务推⼴给商户使⽤,可以授权多个商户使⽤,商户需要通过Oauth2.0的授权码模式授权。
client_id:应⽤的⾝份标识,全局唯⼀的⼀个字符串,应⽤的唯⼀标识,在创建应⽤时分配
client_secret:应⽤的私钥,⼀般配合应⽤的client_id⼀起成对使⽤,⽤来验证应⽤的合法性。
动词释义
授权:开发者所开发的应⽤,想要访问商户的信息,则必须经过商户的同意,由应⽤发起的商户是否同意访问的操作称之为授权。
推送:开放平台向应⽤发送“订单确认”、“打印状态变化”、“打印机状态变化”等消息,称之为向应⽤推送消息。
回调:商户同意或拒绝应⽤的授权请求后,开放平台打开应⽤设置的回调URL并附加上商户同意或拒绝的操作信息,称为开放平台回调应⽤。
接⼊API
⼀般管理⾃⼰的⽆线打印机,都是使⽤“⾃有应⽤服务模式”。利⽤ client_id, client_secret 获取 access_token(访问令牌)。
“⾃有应⽤服务模式”获取 access_token(访问令牌)和终端授权的⽅法()。
每个Client Id 的 Access Token获取或刷新频次限制共: 20次/⽇
该模式下Access Token ⽆失效时间,做好存储避免多次获取导致频次超过限制
PHP SDK
SDK 的使⽤⽅法参考 Github 仓库主页的。
SDK ⾥⾃带了⽂本打印和图形打印等接⼝的封装,可以按照 Usage ⾥的直接调⽤。
如果要调⽤声⾳调节、订单确认等接⼝则需要⾃⼰传⼊合适的参数:
$ylyRpcClient = new YlyRpcClient($access_token, $config);
// 这个接⼝会返回success,但是机器没有反应
$ylyRpcRes = $ylyRpcClient->call('printer/shutdownrestart', array('machine_code' => $machine_code, 'response_type' => 'shutdown'));
$ylyRpcRes = $ylyRpcClient->call('printer/setsound', array('machine_code' => $machine_code, 'response_type' => 'buzzer', 'voice' => 3));
wa字符串是什么// horn 有⼥声语⾳,提⽰“设置成功”
$ylyRpcRes = $ylyRpcClient->call('printer/setsound', array('machine_code' => $machine_code, 'response_type' => 'horn', 'voice' => 3));
// printer/printinfo 返回结果
// object(stdClass)#19 (3) {
// ["error"]=>
// string(1) "0"
// ["error_description"]=>
// string(7) "success"
// ["body"]=>
// object(stdClass)#20 (2) {
// ["version"]=>
// string(2) "k4"
// ["print_width"]=>
// string(4) "58mm"
// }
// }
$ylyRpcRes = $ylyRpcClient->call('printer/printinfo', array('machine_code' => $machine_code));
// printer/getversion 错误此接⼝已废弃!
$ylyRpcRes = $ylyRpcClient->call('printer/getversion', array('machine_code' => $machine_code));
// $ylyRpcRes = $ylyRpcClient->call('printer/getorder', array('machine_code' => $machine_code, 'response_type' => 'close'));
$ylyRpcRes = $ylyRpcClient->call('print/index', array('machine_code' => $machine_code, 'content' => '<FS><center>奇迹出来了</center></FS>', 'origin_id' => mt_rand(100000, 999999))); var_dump($ylyRpcRes);
die;
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论