basePath: / definitions: admin.loginRequest: properties: password: description: 密码 (MD5加密后的密码) type: string username: description: 用户名 type: string required: - password - username type: object admin.loginResponse: properties: token: description: 登录成功后颁发的 Token type: string type: object app.adminSendMessageRequest: properties: app_id: description: 小程序ID type: string content: description: 内容 type: string msg_type: description: 消息类型(1:文本 2:图片) type: integer to_user_id: description: 接收用户ID type: string required: - app_id - content - msg_type - to_user_id type: object app.adminSendMessageResponse: properties: message: description: 提示信息 type: string type: object app.appMessagePageListResponse: properties: list: items: $ref: '#/definitions/app.listMessageData' type: array page: description: 当前页码 type: integer page_size: description: 每页返回的数据量 type: integer total: description: 符合查询条件的总记录数 type: integer type: object app.createAppRequest: properties: app_id: description: 小程序ID type: string avatar: description: 头像 type: string description: description: 描述 type: string name: description: 名称 type: string required: - app_id - name type: object app.createAppResponse: properties: message: description: 提示信息 type: string type: object app.createAppUserRequest: properties: app_id: description: 小程序ID type: string user_avatar: description: 用户头像 type: string user_id: description: 用户ID type: string user_mobile: description: 用户手机号 type: string user_name: description: 用户昵称 type: string required: - app_id - user_id - user_name type: object app.createAppUserResponse: properties: message: description: 提示信息 type: string type: object app.deleteAppRequest: properties: ids: description: 小程序编号(多个用,分割) type: string required: - ids type: object app.deleteAppResponse: properties: message: description: 提示信息 type: string type: object app.listData: properties: app_id: description: 小程序ID type: string avatar: description: 小程序头像 type: string created_at: description: 创建时间 type: string description: description: 小程序描述 type: string id: description: 小程序编号 type: integer name: description: 小程序名称 type: string updated_at: description: 更新时间 type: string type: object app.listMessageData: properties: content: description: 消息内容 type: string msg_type: description: 消息类型(1:文本 2:图片) type: integer receiver_id: description: 接收人ID type: string send_time: description: 发送时间 type: string sender_id: description: 发送人ID type: string sender_name: description: 发送人昵称 type: string type: object app.listResponse: properties: list: items: $ref: '#/definitions/app.listData' type: array page: description: 当前页码 type: integer page_size: description: 每页返回的数据量 type: integer total: description: 符合查询条件的总记录数 type: integer type: object app.modifyAppRequest: properties: app_id: description: 小程序ID type: string avatar: description: 头像 type: string description: description: 描述 type: string name: description: 名称 type: string required: - app_id - name type: object app.modifyAppResponse: properties: message: description: 提示信息 type: string type: object app.userListData: properties: created_at: description: 创建时间 type: string user_avatar: description: 用户头像 type: string user_id: description: 用户ID type: string user_mobile: description: 用户手机号 type: string user_name: description: 用户昵称 type: string type: object app.userListResponse: properties: list: items: $ref: '#/definitions/app.userListData' type: array page: description: 当前页码 type: integer page_size: description: 每页返回的数据量 type: integer total: description: 符合查询条件的总记录数 type: integer type: object code.Failure: properties: code: description: 业务码 type: integer message: description: 描述信息 type: string type: object keyword.createKeywordMaterialRequest: properties: material_list: description: 素材列表 items: $ref: '#/definitions/keyword.keywordMaterial' type: array required: - material_list type: object keyword.createKeywordMaterialResponse: properties: message: description: 提示信息 type: string type: object keyword.createKeywordRequest: properties: app_id: description: 小程序ID type: string keyword: description: 关键字 type: string required: - app_id - keyword type: object keyword.createKeywordResponse: properties: id: description: 关键字ID type: integer message: description: 提示信息 type: string type: object keyword.deleteKeywordResponse: properties: message: description: 提示信息 type: string type: object keyword.keywordListData: properties: app_id: description: 小程序ID type: string created_at: description: 创建时间 type: string created_user: description: 创建人 type: string id: description: 关键字编号 type: integer keyword: description: 意图关键字 type: string material_type_count: description: 素材类型数量 type: string updated_at: description: 更新时间 type: string updated_user: description: 更新人 type: string type: object keyword.keywordMaterial: properties: content: description: 素材内容 type: string interval_seconds: description: 发送间隔时间(单位:秒) type: integer type: description: 素材类型(1:文本 2:图片) type: integer required: - content - interval_seconds - type type: object keyword.keywordMaterialListData: properties: content: description: 素材内容 type: string created_at: description: 创建时间 type: string created_user: description: 创建人 type: string id: description: 主键ID type: integer interval_seconds: description: 素材发送间隔时间(单位:秒) type: integer keyword_id: description: 意图关键字ID type: integer type: description: 素材类型(1:文本 2:图片) type: integer type: object keyword.keywordMaterialPageListResponse: properties: list: items: $ref: '#/definitions/keyword.keywordMaterialListData' type: array page: description: 当前页码 type: integer page_size: description: 每页返回的数据量 type: integer total: description: 符合查询条件的总记录数 type: integer type: object keyword.keywordPageListResponse: properties: list: items: $ref: '#/definitions/keyword.keywordListData' type: array page: description: 当前页码 type: integer page_size: description: 每页返回的数据量 type: integer total: description: 符合查询条件的总记录数 type: integer type: object keyword.modifyKeywordMaterialRequest: properties: content: description: 素材内容 type: string interval_seconds: description: 发送间隔时间(单位:秒) type: integer type: description: 素材类型(1:文本 2:图片) type: integer required: - content - interval_seconds - type type: object keyword.modifyKeywordMaterialResponse: properties: message: description: 提示信息 type: string type: object keyword.modifyKeywordRequest: properties: keyword: description: 意图关键字 type: string required: - keyword type: object keyword.modifyKeywordResponse: properties: message: description: 提示信息 type: string type: object message.appMessagePageListResponse: properties: list: items: $ref: '#/definitions/message.listMessageData' type: array page: description: 当前页码 type: integer page_size: description: 每页返回的数据量 type: integer total: description: 符合查询条件的总记录数 type: integer type: object message.listMessageData: properties: content: description: 消息内容 type: string msg_type: description: 消息类型(1:文本 2:图片) type: integer receiver_id: description: 接收人ID type: string send_time: description: 发送时间 type: string sender_id: description: 发送人ID type: string sender_name: description: 发送人昵称 type: string type: object message.userSendMessageRequest: properties: app_id: description: 小程序ID type: string content: description: 内容 type: string from_user_id: description: 发送用户的ID type: string from_user_name: description: 发送用户的昵称 type: string msg_type: description: 消息类型(1:文本 2:图片) type: integer required: - app_id - content - from_user_id - from_user_name - msg_type type: object message.userSendMessageResponse: properties: message: description: 提示信息 type: string type: object upload.uploadImageResponse: properties: preview_image_url: description: 可预览图片地址 type: string real_image_url: description: 真实图片地址 type: string type: object info: contact: {} title: mini-chat 接口文档 version: v0.0.1 paths: /admin/app/{id}: put: consumes: - application/json description: 编辑小程序 parameters: - description: 编号ID in: path name: id required: true type: string - description: 请求参数 in: body name: RequestBody required: true schema: $ref: '#/definitions/app.modifyAppRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/app.modifyAppResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 编辑小程序 tags: - 管理端.小程序 /admin/app/create: post: consumes: - application/json description: 新增小程序 parameters: - description: 请求参数 in: body name: RequestBody required: true schema: $ref: '#/definitions/app.createAppRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/app.createAppResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 新增小程序 tags: - 管理端.小程序 /admin/app/delete: post: consumes: - application/json description: 删除小程序 parameters: - description: 请求参数 in: body name: RequestBody required: true schema: $ref: '#/definitions/app.deleteAppRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/app.deleteAppResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 删除小程序 tags: - 管理端.小程序 /admin/app/keyword: post: consumes: - application/json description: 添加意图关键字 parameters: - description: 请求参数 in: body name: RequestBody required: true schema: $ref: '#/definitions/keyword.createKeywordRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/keyword.createKeywordResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 添加意图关键字 tags: - 管理端.意图关键字 /admin/app/keyword/{id}: delete: consumes: - application/json description: 删除意图关键字 parameters: - description: 编号ID in: path name: id required: true type: string produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/keyword.deleteKeywordResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 删除意图关键字 tags: - 管理端.意图关键字 put: consumes: - application/json description: 修改意图关键字 parameters: - description: 编号ID in: path name: id required: true type: string - description: 请求参数 in: body name: RequestBody required: true schema: $ref: '#/definitions/keyword.modifyKeywordRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/keyword.modifyKeywordResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 修改意图关键字 tags: - 管理端.意图关键字 /admin/app/keyword/material/{id}: post: consumes: - application/json description: 配置意图关键字素材 parameters: - description: 编号ID in: path name: id required: true type: string - description: 请求参数 in: body name: RequestBody required: true schema: $ref: '#/definitions/keyword.createKeywordMaterialRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/keyword.createKeywordMaterialResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 配置意图关键字素材 tags: - 管理端.意图关键字 put: consumes: - application/json description: 修改意图关键字素材 parameters: - description: 素材编号ID in: path name: id required: true type: string - description: 请求参数 in: body name: RequestBody required: true schema: $ref: '#/definitions/keyword.modifyKeywordMaterialRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/keyword.modifyKeywordMaterialResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 修改意图关键字素材 tags: - 管理端.意图关键字 /admin/app/keyword/materials: get: consumes: - application/json description: 获取意图关键字素材列表 parameters: - description: 意图关键字ID in: query name: keyword_id required: true type: integer - default: 1 description: 当前页码 in: query name: page required: true type: integer - default: 20 description: 每页返回的数据量,最多 100 条 in: query name: page_size required: true type: integer produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/keyword.keywordMaterialPageListResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 获取意图关键字素材列表 tags: - 管理端.意图关键字 /admin/app/keywords: get: consumes: - application/json description: 获取意图关键字列表 parameters: - description: 小程序ID in: query name: app_id required: true type: integer - description: 意图关键字 in: query name: keyword type: string - default: 1 description: 当前页码 in: query name: page required: true type: integer - default: 20 description: 每页返回的数据量,最多 100 条 in: query name: page_size required: true type: integer produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/keyword.keywordPageListResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 获取意图关键字列表 tags: - 管理端.意图关键字 /admin/app/users: get: consumes: - application/json description: 小程序用户列表 parameters: - description: 小程序ID in: query name: app_id required: true type: string - description: 用户昵称 in: query name: user_name type: string - description: 用户ID in: query name: user_id type: string - default: 1 description: 当前页码 in: query name: page required: true type: integer - default: 20 description: 每页返回的数据量,最多 100 条 in: query name: page_size required: true type: integer produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/app.userListResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 小程序用户列表 tags: - 管理端.小程序 /admin/apps: get: consumes: - application/json description: 小程序列表 parameters: - description: 小程序名称 in: query name: name type: string - description: 小程序ID in: query name: app_id type: string - default: 1 description: 当前页码 in: query name: page required: true type: integer - default: 20 description: 每页返回的数据量,最多 100 条 in: query name: page_size required: true type: integer produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/app.listResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 小程序列表 tags: - 管理端.小程序 /admin/login: post: consumes: - application/json description: 管理员登录 parameters: - description: 请求参数 in: body name: RequestBody required: true schema: $ref: '#/definitions/admin.loginRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/admin.loginResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' summary: 管理员登录 tags: - 管理端.登录 /admin/messages: get: consumes: - application/json description: 获取消息日志 parameters: - description: 小程序ID in: query name: app_id required: true type: string - description: 用户ID in: query name: user_id required: true type: string - default: 1 description: 当前页码 in: query name: page required: true type: integer - default: 20 description: 每页返回的数据量,最多 100 条 in: query name: page_size required: true type: integer produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/app.appMessagePageListResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 获取消息日志 tags: - 管理端.小程序 /admin/send_message: post: consumes: - application/json description: 管理员发送消息 parameters: - description: 请求参数 in: body name: RequestBody required: true schema: $ref: '#/definitions/app.adminSendMessageRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/app.adminSendMessageResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' security: - LoginVerifyToken: [] summary: 管理员发送消息 tags: - 管理端.小程序 /admin/upload/image: post: consumes: - multipart/form-data description: 上传图片 parameters: - description: 选择文件 in: formData name: file required: true type: file produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/upload.uploadImageResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' summary: 上传图片 tags: - 通用 /app/messages: get: consumes: - application/json description: 获取消息日志 parameters: - description: 小程序ID in: query name: app_id required: true type: string - description: 用户ID in: query name: user_id required: true type: string - default: 1 description: 当前页码 in: query name: page required: true type: integer - default: 20 description: 每页返回的数据量,最多 100 条 in: query name: page_size required: true type: integer produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/message.appMessagePageListResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' summary: 获取消息日志 tags: - 用户端 /app/send_message: post: consumes: - application/json description: 用户发送消息 parameters: - description: 请求参数 in: body name: RequestBody required: true schema: $ref: '#/definitions/message.userSendMessageRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/message.userSendMessageResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' summary: 用户发送消息 tags: - 用户端 /app/user/create: post: consumes: - application/json description: 新增小程序用户 parameters: - description: 请求参数 in: body name: RequestBody required: true schema: $ref: '#/definitions/app.createAppUserRequest' produces: - application/json responses: "200": description: OK schema: $ref: '#/definitions/app.createAppUserResponse' "400": description: Bad Request schema: $ref: '#/definitions/code.Failure' summary: 新增小程序用户 tags: - 用户端 securityDefinitions: LoginVerifyToken: in: header name: Authorization type: apiKey swagger: "2.0"