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 "全局返回碼說明")”