Merge branch 'master' of git.gengmei.cc:backend/api_document

ascle.yaml

@@ -1022,6 +1022,44 @@ paths:
                     online_time: 1458730446
               message: ''
               error: 0
+
+  /service/register/{register_id}:
+    get:
+      summary: 上传美购
+      description: 拉下医生曾经上传美购数据
+      parameters:
+        - name: register_id
+          in: path
+          description: 上传美购ID
+          required: True
+          type: integer
+          format: integer
+      tags:
+        - Service
+      response:
+        '200':
+          description: OK
+          schema: {}
+          examples:
+            application/json:
+              error: 0
+              message: ''
+              data:
+                comment: '[玻尿酸注射] 这是一个美购的信息'
+                start_time: 134949595
+                end_time: 1433442234
+                reservation: 3
+                total_num: 30
+                image_header: 'http://...'
+                photo_details: 'blabla...'
+                special_permit: false
+                items: '[{}, #json序列化化的数据]
+                    {
+                        tag_ids: [1,3,4],
+                        market_price: 11223,
+                        gengmei_price: 12233,
+                        is_online: true
+                    }'
 # ------------------------
   /search/topic:
     get:

kefu.yaml

+swagger: '2.0'
+info:
+  title: 客服 API
+  version: 1.0.0
+host: doctor.hotfix.gengmei.cc
+schemes:
+  - http
+basePath: /api/web
+paths:
+  /entry/question:
+    get:
+      summary: 分组常见问题
+      description: 分组常见问题
+      tags:
+        - Entry
+      responses:
+        '200':
+          description: OK
+          schema: {}
+          examples:
+            application/json:
+              error: 0
+              message: ''
+              data:
+                - id: "05e12400315442f8995dcdf588cf87bc"
+                  name: '空分组'
+                  sort: 4
+                  questions:
+                    - id: "59852826f91c42a9975d1e6a347f0301"
+                      order: 100
+                      question: "1*2*3*4*5=?"
+                      answer: "5!"
+                      created_time: 1471861749771.449
+    post:
+      summary: 创建常见问题
+      description: 创建常见问题
+      parameters:
+        - name: entry_id
+          in: formData
+          description: 分组名称
+          required: true
+          type: string
+          format: string
+        - name: question
+          in: formData
+          description: 问题
+          required: true
+          type: string
+          format: string
+        - name: answer
+          in: formData
+          description: 分组名称
+          required: true
+          type: string
+          format: string
+      tags:
+        - Entry
+      responses:
+        '200':
+          description: OK
+          schema: {}
+          examples:
+            application/json:
+              error: 0
+              message: ''
+              data:
+                id: "59852826f91c42a9975d1e6a347f0301"
+                order: 100
+                question: "1*2*3*4*5=?"
+                answer: "5!"
+                created_time: 1471861749771.449
+
+  /entry/question/{question_id}/delete:
+    post:
+      summary: 删除分组常见问题
+      description: 删除分组常见问题
+      parameters:
+        - name: question_id
+          in: path
+          description: 问题ID
+          required: true
+          type: string
+          format: string
+      tags:
+        - Entry
+      responses:
+        '200':
+          description: OK
+
+  /transfer/entry/{entry_id}:
+    post:
+      summary: 转接分组
+      description: 把用户转接到某个分组
+      parameters:
+        - name: entry_id
+          in: path
+          description: 分组ID
+          required: true
+          type: string
+          format: string
+        - name: user_person_id
+          in: formData 
+          description: 用户person_id
+          required: true
+          type: string
+          format: string
+      tags:
+        - Entry
+      responses:
+        '200':
+          description: OK
+
+  /conversation/create:
+    post:
+      summary: 客服主动发起会话
+      description: 客服从留言区主动发起会话
+      parameters:
+        - name: user_person_id
+          in: formData 
+          description: 用户person_id
+          required: true
+          type: string
+          format: string
+      tags:
+        - Conversation
+      responses:
+        '200':
+          description: OK
+
+
+  /kefu_response:
+    get:
+      summary: 客服自动回复
+      description: 客服自动回复, category 见 gm-types/zeus/types#KEFU_RESPONSE
+      tags:
+        - Response
+      responses:
+        '200':
+          description: OK
+          schema: {}
+          examples:
+            application/json:
+              error: 0
+              message: ''
+              data:
+                - id: "05e12400315442f8995dcdf588cf87bc"
+                  category: 1
+                  content: '客服忙 请稍后欢迎来到更美客服欢迎来到更美客服欢迎来到更美客服'
+                  minute: 6
+                  enable: true
+    post:
+      summary: 创建常见问题
+      description: 创建常见问题
+      parameters:
+        - name: settings
+          in: formData
+          description: json字符串，格式同get
+          required: true
+          type: string
+          format: string
+      tags:
+        - Response
+      responses:
+        '200':
+          description: OK