# 图片打印
### 一、调用前提
1. 图片打印只能识别jpg、jpeg、png格式的图片,推荐使用jpg、jpeg格式。
2. 关于打印图片宽度说明,58mm纸宽的打印纸下图片的宽度像素不能超过384px。m与px之间的换算比例:1mm≈8px。
3. 图片大小限制说明,58mm纸宽的打印纸下图片大小计算:(像素宽/8)*像素高 < 100kb,对于K5下图片大小计算:(像素宽/8)*像素高 < 200kb
### 二、打印接口
#### 接口信息
|协议|方式|地址
|-|-|-|
|https|POST|/pictureprint/index
#### 请求参数
|名称|类型|必填|描述
|-|-|-|-|-|
|client_id|string|是|应用id
|sign|string|是|签名
|timestamp|int|是|时间戳(秒)
|id|string|是|请求唯一标识码
|access_token|string|是|调用凭证
|machine_code|string|是|终端号
|origin_id|string|是|开发者侧,订单id,内容自定义,64个字节内
|picture_url|string|是|在线图片链接
|idempotence|int|否|默认`1`,传入本参数,会根据origin_id进行幂等处理,2小时内相同origin_id会返回上一次的结果
#### 响应参数
|名称|类型|描述
|-|-|-|-|
|error|int|成功0,其他为异常
|error_description|string|提示信息
|timestamp|int|时间戳(秒)
|body|json|数据
#### body 字段示例
```json
{
"id": 2099743426,
"origin_id": "test1"
}
```
#### body 字段说明
|名称|类型|空|描述
|-|-|-|-|
|id|int|否|易联云侧,打印id,采用bigint类型存储
|origin_id|string|否|开发者侧,订单id
- 使用前准备【必看】
- 开发者服务指引【必看】
- 接口更新动态
- 2024年5月
- 2024年1月
- 2023年11月
- 2023年10月
- 2023年9月
- 2023年6月
- 开发文档【必看】
- 调用协议【必看】
- 授权文档【必接】
- 自有型应用
- 开放型应用(OAuth2.0授权码模式)
- 开放型应用(扫码授权模式)
- SDK使用说明
- API文档【按需对接】
- 设备文档
- 设备绑定
- 设备解绑或取消授权
- 状态获取
- 离线或重启控制
- 打印控制
- logo控制
- 音效音量控制
- 内置语音控制
- 打印宽度获取
- 型号版本获取
- 接单拒单控制
- 打印文档
- 文本打印
- 图片打印
- 面单文档
- 面单生成并打印
- 面单取消
- 打印队列文档
- 订单状态获取(单订单)
- 订单列表获取
- 订单取消打印(单订单)
- 订单取消打印(全量)
- 订单重打(单订单)
- 应用设置文档
- 推送地址设置
- K8支付设置文档
- 推送开关设置
- 关键词设置
- 高级设置
- 打印消息推送
- 打印消息推送说明
- 打印完成推送
- 终端状态推送
- 接单拒单推送
- K8扫码信息推送
- 扫码相关功能流程图
- 产品介绍
- 授权说明
- 消息推送
- http/https推送方式
- 签名验证规则
- 解密规则
- 指令说明
- 验签解密示例
- 打印指令文档
- 指令文档说明
- 文本打印指令集
- 语音指令文档
- 多语言指令文档
- 扫码功能指令
- 常见问题
- 错误码说明
- FAQ