达人店后台接口-海豚仓

1,订单推送列表获取

request

method: GET  
url: /shop/v1/order/push-message/list?page=1&pageSize=10&startTimeStr=time1&endTimeStr=time2&platFormId=8&status=0&orderId=1234  

参数说明

参数名 类型 必填 描述

startTimeStr

string

开始时间2016-11-10 00:00:00

endTimeStr

string

结束时间2016-12-01 00:00:00

platFormId

string

推送平台,0-海淘,8海豚

status

string

状态,0-成功,1-失败

page

string

页数

pageSize

string

每页的数量

orderId

string

订单号(以订单号搜索,如果提供该参数则按订单号查)

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  "data": {
    "count": 49,
    "dataList": [
      {
        "gmtCreate": 1480480819000,
        "orderId": 6448708,
        "platForm": 8,
        "platFormName": "海豚供货商",
        "status": 0
      },
    ...
    ]
  }
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

2,推送信息详情

request

method: GET  
url: /shop/v1/order/push-message/detail?orderId=123  

参数说明

参数名 类型 必填 描述

orderId

string

orderId

response

body:{  
  "code": 1,
  "message": "success",
  "data": {
    "content": "[{\"address\":\"崇桂新村82幢304室\",\"city\":\"三明\",\"consignee\":\"孙梦遐\",\"consumerNote\":\"\",\"country\":\"中国\",\"district\":\"梅列区\",\"idCardNumber\":\"350203198302073026\",\"isCheck\":\"no\",\"items\":[{\"goodsName\":\"保税区直发 澳大利亚Swisse液体血橙胶原蛋白饮料500ml【2件起发】\",\"goodsPrice\":\"104.5\",\"goodsSn\":\"AUSW001\",\"quantity\":\"2\"}],\"mobile\":\"13313806327\",\"moneyPaid\":\"209.0\",\"orderAmount\":\"209.0\",\"orderSn\":\"6448708\",\"paymentAccount\":\"htdolphin@163.com\",\"paymentInfoIdCardNumber\":\"350203198302073026\",\"paymentInfoMethod\":\"支付宝\",\"paymentInfoName\":\"孙梦遐\",\"paymentInfoNumber\":\"2016112821001004240280799510\",\"province\":\"福建\",\"shippingFee\":\"0.0\",\"siteName\":\"达人店\",\"siteType\":\"尚妆\",\"tel\":\"\",\"zipcode\":\"\"}]",
    "gmtCreate": 1480480819000,
    "gmtModified": 1480480819000,
    "id": 6,
    "orderId": 6448708,
    "platForm": 1,
    "returnMess": "{\"data\":{\"6448708\":{\"status\":\"yes\"}},\"status\":\"20000\",\"time\":1480480807}",
    "status": 0
  },
  "pageCount": 1,
  "pageCurrent": 1,
  "isRedirect": 0,
  "redirect": "",
  "login": 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

3,海豚商品列表

request

method: GET  
url: /shop/v1/supplier/product/list?page=1&pageSize=10  

参数说明

参数名 类型 必填 描述

page

string

页数

pageSize

string

每页的数量

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  "data":[
    {
      "outSkuId": "AOAA004",
      "skuId": 149138,
      "name": "保税区直发 新西兰A2 袋装高钙全脂高蛋白儿童学生成人奶粉1kg【2袋起发】(保质期到2017年4月)",
      "platFormId": 8,
      "inventory": 0,
      "platFormName": "海豚供货商",
      "gmtCreate": 1480476555000
    },
    ...
  ]
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

4,添加商品

request

method: POST  
url: /shop/v1/supplier/product/add

body = {  
  outSkuId: 1,
  platFormId: 8,
  skuId: 2
}
    

参数说明

参数名 类型 必填 描述

outSkuId

number

商品外部ID

platFormId

number

平台

skuId

number

商品站内ID

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  'data': [],
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

1200

添加失败

5,获取商品详情

request

method: GET  
url: /shop/v1/supplier/product/get?skuId=111  
    

参数说明

参数名 类型 必填 描述

skuId

number

商品ID

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  'data': {
    "outSkuId": "AOAA004",
    "skuId": 149138,
    "name": "保税区直发 新西兰A2 袋装高钙全脂高蛋白儿童学生成人奶粉1kg【2袋起发】(保质期到2017年4月)",
    "outerProductInfo": "product info",
    "platFormId": 8,
    "inventory": 0,
    "platFormName": "海豚供货商",
    "gmtCreate": 1480476555000
  },
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

6,展示套装商品

request

method: GET  
url: /shop/v1/supplier/suit-product/list
    

参数说明

参数名 类型 必填 描述

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  'data': [
    {
      "suitSkuId": 148279,
      "skuId": 148279,
      "saleAmount": 2,
      "name": "保税区直发 澳大利亚Swisse液体血橙胶原蛋白饮料500ml【2件起发】"
    },
  ...
  ],
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

7,添加套装商品

request

method: POST  
url: /shop/v1/supplier/suit-product/add

body = {  
  suitSkuId: 1,
  saleAmount: 8,
  skuId: 2
}
    

参数说明

参数名 类型 必填 描述

suitSkuId

number

套装ID

saleAmount

number

数量

skuId

number

商品ID

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  'data': [],
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

1200

添加失败

8,删除套装商品

request

method: DELETE  
url: /shop/v1/supplier/suit-product/delete

body = {  
  suitSkuId: 1,
  skuId: 2
}
    

参数说明

参数名 类型 必填 描述

suitSkuId

number

套装ID

skuId

number

商品ID

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  'data': [],
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

1200

删除失败

9,订单推送列表下载

request

method: GET  
url: /shop/v1/order/push-message/list/export?page=1&pageSize=10&startTimeStr=time1&endTimeStr=time2&platFormId=8&status=0&orderId=1234  

参数说明

参数名 类型 必填 描述

startTimeStr

string

开始时间2016-11-10 00:00:00

endTimeStr

string

结束时间2016-12-01 00:00:00

platFormId

string

推送平台,0-海淘,8海豚

status

string

状态,0-成功,1-失败

page

string

页数,大于0下载当前页, 等于0下载所有

pageSize

string

每页的数量

orderId

string

订单号(以订单号搜索,如果提供该参数则按订单号查)

response

1,正常返回(浏览器自动下载表格) Content-Type: application/vnd.openxmlformats Content-Disposition: attachment; filename=订单推送列表.xlsx body:{ 'code': 1, 'message': 'success', 'pageCount': 1, 'pageCurrent': 1, 'data': binary, 'isRedirect': 0, 'redirect': 'url', 'login': 0 } 2,异常返回 body:{ 'code': 1100, 'message': '缺少时间段', 'pageCount': 1, 'pageCurrent': 1, 'data': null, 'isRedirect': 0, 'redirect': 'url', 'login': 0 }

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

沐风

继续阅读此作者的更多文章