印鸽开放平台

印鸽开放平台

    ›供应链

    供应链

    • 接入说明
    • 接口公共参数
    • 获取订单
    • 获取订单物流面单
    • 获取合并生产的订单
    • 下载回调
    • 生产回调
    • 签名算法
    • 产品参数一览
    • 物流参数一览

    商家

    • 商家接口说明
    • 接口公共参数
    • 商家接口签名算法
    • 商家上传过照片的用户信息

    获取订单

    印鸽将订单数据放在该接口中提供给生产方。

    1. 丢失或者未回调下载完成接口,订单数据会在3小时后重新放入队列,对于前者,需要捕获异常,避免订单丢失造成生产时效问题。
    2. 在订单未开始生产的情况下,如果接收重复订单,需要覆盖生产方系统中原订单。

    请求方式

    GET /api/factory/orders
    

    请求业务参数

    参数名类型是否必须说明
    sizeint否拉取订单的数量,限1~50,默认50,最大值为100

    响应结果

    以下数据包含在 data 字段中

    字段名类型是否必须说明
    ordersarray是订单列表,详细字段见下方

    订单详细信息

    字段名类型是否必须说明
    orderIdint是订单id
    orderTimeint是订单时间,时间戳,单位秒
    expressstring否物流公司简称,HTKY、STO等,详情查看 物流参数,默认为空
    addressobject是收货信息,详细字段见下方
    productsarray是商品信息,详见下方

    订单地址信息

    字段名类型是否必须说明
    consigneestring是收件人
    phonestring是收件号码
    provincestring是省,如浙江省、上海市
    citystring是市,例如杭州市
    districtstring是区,例如西湖区
    detailstring是详细地址

    订单商品信息

    字段名类型是否必须说明
    productCodeint是商品编码,对应要生产发货给用户的商品
    productNamestring是商品名称
    productCountint是购买份数
    listarray否标品list为空,其他商品不同分类有不同的结构,详见下

    照片类商品描述

    字段名类型是否必须说明
    urlstring是图片地址
    hashstring是图片hash,需要对下载完成的图片进行hash校验,以保证图片完整性。算法详见这里
    countint是打印张数
    sortint是顺序值

    响应示例

    {
        "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
                        }
                    ]
                }
            ]
        }
    }
    
    
    ← 接口公共参数获取订单物流面单 →
    • 请求方式
    • 请求业务参数
    • 响应结果
      • 订单详细信息
      • 订单地址信息
      • 订单商品信息
      • 照片类商品描述
    • 响应示例
    Copyright © 2019 印鸽科技