戴晖 / API-Interfaces · Commits

Go to a project

Authored by qianjun
Commit 92851473f9d5ad188a84261a6b2aa646fb169c21 1 parent 7b5b8205

update

Inline Side-by-side
Showing 1 changed file with 71 additions and 67 deletions
1 -# 修改订单收货地址服务接口  
2 -  
3 -## 接口列表  
4 -| 接口名称 | 接口描述 |  
5 -| --------| -------- |  
6 -|[app.SpaceOrders.updateDeliveryAddress](#1-app-spaceorders-updatedeliveryaddress)|修改订单收货地址|  
7 -|[修改订单收货地址MQ](#2-mq)|修改订单收货地址MQ|  
8 -  
9 -  
10 -  
11 -## 接口描述  
12 -  
13 -### 1、修改订单收货地址(app.SpaceOrders.updateDeliveryAddress)  
14 -  
15 -#### 请求参数  
16 -| Param Name | Param Type | Required | Param Value | Desc |  
17 -| :-- | --: | --: | --: | --: |  
18 -| method | String | true | app.SpaceOrders.updateDeliveryAddress| 请求方法|  
19 -| order_code | String | true | "1607472719" |订单号 |  
20 -| address_id | String | true | "944005" |地址ID|  
21 -### 错误编码  
22 --------------------------  
23 -|错误码code|消息|  
24 -|----------|----|  
25 -|400|收货地址ID不存在|  
26 -|401|该订单不存在|  
27 -|402|该订单已被删除|  
28 -|403|该订单已发货|  
29 -|404|不存在该地区|  
30 -|405|收货地址仅且只能修改1次|  
31 -|406|收货地址不支持顺丰速运可配送的地区|  
32 -|407|该订单已经取消|  
33 -#### 响应内容  
34 -```json  
35 -{  
36 - "alg": "SALT_MD5",  
37 - "code": 200,  
38 - "md5": "1f7d1c5c325209e77f0989134e7a8b67",  
39 - "message": "修改订单收货地址成功"  
40 -}  
41 -```  
42 -  
43 -## 2、修改订单收货地址MQ  
44 -  
45 -### MQ消息数据结构  
46 -| | |  
47 -| :-- | :-- |  
48 -| exchanges | amq.topic |  
49 -| route key | order.deliveryAddress |  
50 -  
51 -```json  
52 -{  
53 - "address": "靖南大街688-10号2楼",  
54 - "address_id": 61,  
55 - "area_code": 330225,  
56 - "city": "宁波市",  
57 - "district": "象山县",  
58 - "email": "canvas220@sina.com",  
59 - "mobile": "15258109727",  
60 - "order_code": 1607472719,  
61 - "parent_order_code": 123,  
62 - "phone": "057465772167",  
63 - "province": "浙江省",  
64 - "user_name": "朱倩倩",  
65 - "zip_code": 315700  
66 -}  
67 -``` 1 +# 修改订单收货地址服务接口
  2 +
  3 +## 接口列表
  4 +| 接口名称 | 接口描述 |
  5 +| --------| -------- |
  6 +|[app.SpaceOrders.updateDeliveryAddress](#1-app-spaceorders-updatedeliveryaddress)|修改订单收货地址|
  7 +|[修改订单收货地址MQ](#2-mq)|修改订单收货地址MQ|
  8 +
  9 +
  10 +
  11 +## 接口描述
  12 +
  13 +### 1、修改订单收货地址(app.SpaceOrders.updateDeliveryAddress)
  14 +
  15 +#### 请求参数
  16 +| Param Name | Param Type | Required | Param Value | Desc |
  17 +| :-- | --: | --: | --: | --: |
  18 +| method | String | true | app.SpaceOrders.updateDeliveryAddress| 请求方法|
  19 +| order_code | String | true | "1607472719" |订单号 |
  20 +| address_id | String | true | "944005" |地址ID|
  21 +
  22 +#### 请求示例
  23 +http://devapi.yoho.cn:58078?method=app.SpaceOrders.updateDeliveryAddress&order_code=160103590&debug=XYZ&address_id=944005
  24 +
  25 +### 错误编码
  26 +-------------------------
  27 +|错误码code|消息|
  28 +|----------|----|
  29 +|400|收货地址ID不存在|
  30 +|401|该订单不存在|
  31 +|402|该订单已被删除|
  32 +|403|该订单已发货|
  33 +|404|不存在该地区|
  34 +|405|收货地址仅且只能修改1次|
  35 +|406|收货地址不支持顺丰速运可配送的地区|
  36 +|407|该订单已经取消|
  37 +#### 响应内容
  38 +```json
  39 +{
  40 + "alg": "SALT_MD5",
  41 + "code": 200,
  42 + "md5": "1f7d1c5c325209e77f0989134e7a8b67",
  43 + "message": "修改订单收货地址成功"
  44 +}
  45 +```
  46 +
  47 +## 2、修改订单收货地址MQ
  48 +
  49 +### MQ消息数据结构
  50 +| | |
  51 +| :-- | :-- |
  52 +| exchanges | amq.topic |
  53 +| route key | order.deliveryAddress |
  54 +
  55 +```json
  56 +{
  57 + "address": "靖南大街688-10号2楼",
  58 + "address_id": 61,
  59 + "area_code": 330225,
  60 + "city": "宁波市",
  61 + "district": "象山县",
  62 + "email": "canvas220@sina.com",
  63 + "mobile": "15258109727",
  64 + "order_code": 1607472719,
  65 + "parent_order_code": 123,
  66 + "phone": "057465772167",
  67 + "province": "浙江省",
  68 + "user_name": "朱倩倩",
  69 + "zip_code": 315700
  70 +}
  71 +```
68 ### 注意 1.JIT拆单和预售商品拆单有关联其他订单，主订单号parent_order_code为1607472719；2.没有关联其他订单，主订单号parent_order_code字段可能不存在。 72 ### 注意 1.JIT拆单和预售商品拆单有关联其他订单，主订单号parent_order_code为1607472719；2.没有关联其他订单，主订单号parent_order_code字段可能不存在。