印鸽将订单数据放在该接口中提供给生产方。
- 丢失或者未回调下载完成接口,订单数据会在3小时后重新放入队列,对于前者,需要捕获异常,避免订单丢失造成生产时效问题。
- 在订单未开始生产的情况下,如果接收重复订单,需要覆盖生产方系统中原订单。
请求方式
GET /api/factory/orders
请求业务参数
| 参数名 | 类型 | 是否必须 | 说明 |
| size | int | 否 | 拉取订单的数量,限1~50,默认50,最大值为100 |
响应结果
以下数据包含在 data 字段中
| 字段名 | 类型 | 是否必须 | 说明 |
| orders | array | 是 | 订单列表,详细字段见下方 |
订单详细信息
| 字段名 | 类型 | 是否必须 | 说明 |
| orderId | int | 是 | 订单id |
| orderTime | int | 是 | 订单时间,时间戳,单位秒 |
| express | string | 否 | 物流公司简称,HTKY、STO等,详情查看 物流参数,默认为空 |
| address | object | 是 | 收货信息,详细字段见下方 |
| products | array | 是 | 商品信息,详见下方 |
订单地址信息
| 字段名 | 类型 | 是否必须 | 说明 |
| consignee | string | 是 | 收件人 |
| phone | string | 是 | 收件号码 |
| province | string | 是 | 省,如浙江省、上海市 |
| city | string | 是 | 市,例如杭州市 |
| district | string | 是 | 区,例如西湖区 |
| detail | string | 是 | 详细地址 |
订单商品信息
| 字段名 | 类型 | 是否必须 | 说明 |
| productCode | int | 是 | 商品编码,对应要生产发货给用户的商品 |
| productName | string | 是 | 商品名称 |
| productCount | int | 是 | 购买份数 |
| list | array | 否 | 标品list为空,其他商品不同分类有不同的结构,详见下 |
照片类商品描述
| 字段名 | 类型 | 是否必须 | 说明 |
| url | string | 是 | 图片地址 |
| hash | string | 是 | 图片hash,需要对下载完成的图片进行hash校验,以保证图片完整性。算法详见这里 |
| count | int | 是 | 打印张数 |
| sort | int | 是 | 顺序值 |
响应示例
{
"data": {
"orders": [
{
"orderId": 123,
"orderTime":"1548741763",
"express":"HTKY",
"address": {
"consignee": "Nico",
"phone": "13812341234",
"province": "浙江省",
"city": "杭州市",
"district": "西湖区",
"detail": "郡原公元里"
},
"products": [
{
"productCode": 100012,
"productName": "4寸lomo卡照片",
"productCount": 10,
"list": [
{
"url": "http://img.mutonginc.xyz/2018/11/06/a05f79e7-8d19-4521-ac7d-bd54f14b222e.jpg",
"hash": "FjheloTcO0nlA7IKCCu7-_c50R_w",
"count": 2
},
{
"url": "http://img.mutonginc.xyz/2018/11/13/4a740d29-9ca9-4bee-8dff-08735b73b21d.jpg",
"hash": "FvhduKtdAk0judwVk7fZ8LG3kFvl",
"count": 1
}
]
},
{
"productCode": 100013,
"productName": "覆膜相册",
"productCount": 1
}
]
}
]
}
}