FIX - url 参数定义方式

ascle.yaml

@@ -876,10 +876,17 @@ paths:
                   - name: 眼睛
                     id: 123
 
-  /topic/<topic_id>:
+  /topic/{topic_id}:
     get:
       summary: 帖子详情
       description: 帖子详情
+      parameters:
+        - name: topic_id
+          in: path
+          description: 帖子ID
+          required: true
+          type: integer
+          format: integer
       tags:
         - Topic
       responses:
@@ -907,11 +914,17 @@ paths:
                     image: "http://pic.gengmei.cc/2015/05/25/35fe857608-w"
 
 
-  /topic/<topic_id>/reply:
+  /topic/{topic_id}/reply:
     get:
       summary: 帖子回复
       description: 帖子回复
       parameters:
+        - name: topic_id
+          in: path
+          description: 帖子ID
+          required: false
+          type: integer
+          format: integer
         - name: page
           in: query
           description: 请求第几页的数据，默认为1
@@ -950,78 +963,97 @@ paths:
                     comment_user_type: 2
                 reply_date: 128833445
 
-  /topic/<topic_id>/reply/<reply_id>:
+  /topic/{topic_id}/reply/{reply_id}:
     post:
       summary: 回复
       description: 回复话题，回复话题的回复
-      parameters:
-        - name: content
-          in: query
-          description: 回复的内容
-          required: true
-          type: string 
-          format: string 
-      tags:
-        - Topic
-      responses:
-        '200':
-          description: OK
-
-  /topic/<topic_id>/sink:
-    post:
-      summary: 话题下沉
-      description: 更改话题分值，话题往后排
       parameters:
         - name: topic_id
-          in: query
-          description: 话题ID
-          required: true
-          type: integer 
-          format: integer 
-      tags:
-        - Topic
-      responses:
-        '200':
-          description: OK
+          in: path
+      description: 话题ID
+      required: true
+      type: integer
+      format: integer
+    - name: reply_id
+      in: path
+      description: 回复ID
+      required: true
+      type: integer 
+      format: integer 
+    - name: content
+      in: query
+      description: 回复的内容
+      required: true
+      type: string 
+      format: string 
+  tags:
+    - Topic
+  responses:
+    '200':
+      description: OK
 
-  /conversation:
-    get:
-      summary: 私信列表
-      description: 私信列表
-      parameters:
-        - name: page
-          in: query
-          description: 页数
-          required: false
-          type: integer 
-          format: integer
-      tags:
-        - Conversation
-      responses:
-        '200':
-          description: OK
-          schema: {}
-          examples:
-            application/json:
-              message: ''
-              error: 0
-              data:
-                - jump_value: "111549_602329"
-                  is_new: false
-                  user_key: "111549_602329"
-                  doctor_id: ""
-                  id: 1270639
-                  jump_type: "6"
-                  nickname: "发疯了的猫"
-                  portrait: "http://pic.gengmei.cc/2015/09/08/1226facfe0"
-                  hospital_id: ""
-                  last_reply_time: 145554334
-                  text: "呵呵大"
+/topic/{topic_id}/sink:
+post:
+  summary: 话题下沉
+  description: 更改话题分值，话题往后排
+  parameters:
+    - name: topic_id
+      in: path
+      description: 话题ID
+      required: true
+      type: integer 
+      format: integer 
+  tags:
+    - Topic
+  responses:
+    '200':
+      description: OK
+
+/conversation:
+get:
+  summary: 私信列表
+  description: 私信列表
+  parameters:
+    - name: page
+      in: query
+      description: 页数
+      required: false
+      type: integer 
+      format: integer
+  tags:
+    - Conversation
+  responses:
+    '200':
+      description: OK
+      schema: {}
+      examples:
+        application/json:
+          message: ''
+          error: 0
+          data:
+            - jump_value: "111549_602329"
+              is_new: false
+              user_key: "111549_602329"
+              doctor_id: ""
+              id: 1270639
+              jump_type: "6"
+              nickname: "发疯了的猫"
+              portrait: "http://pic.gengmei.cc/2015/09/08/1226facfe0"
+              hospital_id: ""
+              last_reply_time: 145554334
+              text: "呵呵大"
 
-  /conversation/<target_user_id>:
+/conversation/{target_user_id}:
     get:
       summary: 私信详情 
       description: 私信详情
+      parameters:
+        - name: target_user_id
+          in: path
+          description: 私信用户ID
+          required: true
+          type: integer
+          format: integer
       tags:
         - Conversation
       responses: