Jelajahi Sumber

完善订阅接口文档

gmw 6 tahun lalu
induk
melakukan
1a23971205
2 mengubah file dengan 4 tambahan dan 12 penghapusan
  1. 2 2
      PROBLEMS.md
  2. 2 10
      README.md

+ 2 - 2
PROBLEMS.md

@@ -33,9 +33,9 @@
 
 ## 车次订阅接口与订单订阅接口
 
-<p>&emsp;&emsp;<b>相同点</b>:两者均为调用成功后即开始推送,无需指定车次号(订单号),当某一个车次(订单)状态变化时便会返回报文。
+<p>&emsp;&emsp;<b>相同点</b>:两者均为订阅成功后即开始推送,无需指定车次号(订单号),订阅的是状态,不是某一个订单,任何变化到你订阅的状态的车次(订单)都会推送至订阅时指定的回调地址。例如:订阅的状态是40000(指派车次),那当你系统中有车次被指派发布的时候该车次就会进行推送
 <p>&emsp;&emsp;<b>不同点</b>:一个车次中可以包含多个订单,两者的状态是不同的,车次状态的改变未必会导致订单状态改变,只有当车次状态变化时才会回调车次报文,订单接口同理。所以需要根据需求决定使用哪一个接口,或者两个结合使用。
-<p>&emsp;&emsp;<b>注</b>:订单订阅请使用V2接口
+<p>&emsp;&emsp;<b>注</b>:回调地址的返回结果需要为json格式,如果成功要在返回信息中包含"code": 200,系统会根据这个值来判断消息是否投递成功,否则会重新进行投递
 <p>&emsp;&emsp;以下为两者状态的详细信息
 
 <div align="center">

+ 2 - 10
README.md

@@ -873,7 +873,7 @@
 
 ## 订单订阅接口
 
-**简要描述:** 订单订阅
+**简要描述:** 订单订阅,请先阅读<a href="PROBLEMS.md#车次订阅接口与订单订阅接口">常见问题</a>
 
 **请求 URL:** `/order/subscribe/v2`
 
@@ -926,10 +926,6 @@
 }
 ```
 
-### **注意事项**
-
-回调地址的返回结果需要为json格式,如果成功要在返回信息中包含"code": 200,系统会根据这个值来判断消息是否投递成功,否则会重新进行投递
-
 ## 取消订单订阅接口
 
 **简要描述:** 取消订单订阅
@@ -966,7 +962,7 @@
 
 ## 车次订阅接口
 
-**简要描述:** 车次订阅
+**简要描述:** 车次订阅,请先阅读<a href="PROBLEMS.md#车次订阅接口与订单订阅接口">常见问题</a>
 
 **请求 URL:** `/order/orderPack/subscribe`
 
@@ -1019,10 +1015,6 @@
 }
 ```
 
-### **注意事项**
-
-回调地址的返回结果中,如果成功要在返回信息中包含"code": 200,系统会根据这个值来判断消息是否投递成功,否则会重新进行投递
-
 ## 取消车次订阅接口
 
 **简要描述:** 取消车次订阅