:construction: create

openapi/public/assets/protocol/resources/discussion/discussion.yaml

@@ -0,0 +1,3 @@
+properties:
+  title:
+    type: string

openapi/public/assets/protocol/resources/discussion/index.yaml

@@ -0,0 +1,28 @@
+get:
+  summary: Returns a list of discussions.
+  tags:
+    - discussion
+  description: 返回多行数据。支持关键字搜索，分页，排序
+  parameters:
+    - name: view
+      in: path
+      required: true
+      description: 查询的视图。如:resId  parent 等
+      schema:
+        type: string
+        enum:
+          - resId
+          - parent
+  responses:
+    "200": # status code
+      description: A JSON array of user names
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              ok:
+                type: boolean
+              message:
+                type: string
+$ref: "./store.yaml"

openapi/public/assets/protocol/resources/discussion/store.yaml

@@ -0,0 +1,39 @@
+post:
+  summary: 新建一条discussion.
+  tags:
+    - discussion
+  description:
+  parameters:
+    - name: title
+      in: path
+      required: false
+      description: title of discussion 建立新问题时, title为必填项目
+      schema:
+        type: string
+    - name: content
+      in: path
+      required: false
+      description: content of discussion
+      schema:
+        type: string
+    - name: parent
+      in: path
+      required: false
+      description: 回答的问题的id. 建立问题时无需此参数。建立回答时需要。
+      schema:
+        type: uuid
+  responses:
+    "200": # status code
+      description: A JSON array of user names
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              ok:
+                type: boolean
+              message:
+                type: string
+              data:
+                type: object
+                $ref: "./discussion.yaml"