JSON数据详见“[全局返回码说明](https://www.showdoc.cc/1687352?page_id=137418124005771 "全局返回码说明")”
~~~[sequence]
第三方应用->印美图服务器: Post(设备编号、图片地址、任务号、应用ID)
印美图服务器-->第三方应用:Return 返回值
Note right of 印美图服务器: 开始打印
印美图服务器->>第三方应用: 回调:打印任务已完成
~~~
~~~[api]
post:https://api.open.feyin.net/welomo/msg?access_token=ACCESS_TOKEN
*string:device_no=默认值#机器编号
*img_url=无默认值#需要打印的照片地址,如:“http://www.welomo.com/develop/test.jpg”
msg_no#第三方系统针对本消息的唯一标示,譬如订单id等业务id,以便消息完成打印回调时能准确定位业务, 如果没有指定,飞印平台会自动生成一个唯一的消息id并通过接口返回
appid#开发者在印美图平台创建的第三方应用id
<<<
post
请求示例(给自有设备)
{
"device_no": "4600408123456789",
"msg_no":"ORDER-201712201500",
"img_url": "http://onmgrcbeg.bkt.clouddn.com/xxxxxxxx.jpg"
}
请求示例(给授权设备)
json
{
"appid": "aaaaaf0eb8222228c6c5254000bbbbb",
"device_no": "4600408123456789",
"msg_no":"ORDER-201712201500",
"img_url": "http://onmgrcbeg.bkt.clouddn.com/xxxxxxxx.jpg"
}
<<<
success
正常情况下,飞印开放平台会返回下述JSON数据:
```json
{
"msg_no":"ORDER-201712201500"
}
```
<<<
error
错误时飞印开放平台会返回错误码等信息,JSON数据示例如下:
```json
{
"errcode":10001,
"errmsg":"invalid appid"
}
```
~~~
**简要描述:**
- 发送照片打印请求
**请求URL:**
- ` https://api.open.feyin.net/welomo/msg?access_token=ACCESS_TOKEN `
**请求方式:**
- POST,JSON提交
**参数:**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|device_no |是 |string | 机器编号|
|img_url |是 |string | 需要打印的照片地址, 如"http://onmgrcbeg.bkt.clouddn.com/xxxxxxxx.jpg"|
|msg_no |否 |string |第三方系统针对本消息的唯一标示,譬如订单id等业务id,以便消息完成打印回调时能准确定位业务, 如果没有指定,飞印平台会自动生成一个唯一的消息id并通过接口返回|
|appid |否 |string | 开发者在印美图平台创建的第三方应用id|
**请求示例(给自有设备)**
```json
{
"device_no": "4600408123456789",
"msg_no":"ORDER-201712201500",
"img_url": "http://onmgrcbeg.bkt.clouddn.com/xxxxxxxx.jpg"
}
```
**请求示例(给授权设备)**
```json
{
"appid": "aaaaaf0eb8222228c6c5254000bbbbb",
"device_no": "4600408123456789",
"msg_no":"ORDER-201712201500",
"img_url": "http://onmgrcbeg.bkt.clouddn.com/xxxxxxxx.jpg"
}
```
**返回示例**
正常情况下,飞印开放平台会返回下述JSON数据:
```json
{
"msg_no":"ORDER-201712201500"
}
```
**返回参数说明**
|参数名|必选|类型|说明|
|:---- |:---|:----|:-----|
|msg_no |是 |string | 本次打印消息的唯一标记,如果在api请求时有指定 msg_no, 则此处跟请求时指定的值一样; 如果时未指定,飞印平台会自动生成一个唯一的消息id|
错误时飞印开放平台会返回错误码等信息,JSON数据示例如下:
```json
{
"errcode":10001,
"errmsg":"invalid appid"
}
```
JSON数据详见“[全局返回码说明](https://www.showdoc.cc/1687352?page_id=137418124005771 "全局返回码说明")”