1/trading-go/docs/swagger.yaml

basePath: /WeChatTrading/trading-go
definitions:
  controller.NewRec:
    properties:
      cIds:
        items:
          type: integer
        type: array
      uid:
        type: integer
    type: object
  model.Appraise:
    properties:
      buyerId:
        type: integer
      content:
        type: string
      goodsId:
        type: integer
      id:
        type: integer
      star:
        type: integer
      time:
        type: integer
    type: object
  model.AppraiseJson:
    properties:
      buyerId:
        type: integer
      content:
        type: string
      goodsId:
        type: integer
      star:
        type: integer
      time:
        type: integer
    type: object
  model.CategoryJson:
    properties:
      name:
        type: string
      pic:
        type: string
    type: object
  model.Goods:
    properties:
      desc:
        type: string
      id:
        type: integer
      ownerId:
        example: "0"
        type: string
      pic:
        items:
          type: string
        type: array
      place:
        type: string
      price:
        type: integer
      state:
        type: integer
      title:
        type: string
    type: object
  model.GoodsJson:
    properties:
      categories:
        items:
          type: integer
        type: array
      desc:
        type: string
      ownerId:
        example: "0"
        type: string
      pic:
        items:
          type: string
        type: array
      place:
        type: string
      price:
        type: integer
      state:
        type: integer
      title:
        type: string
    type: object
  model.OrderJson:
    properties:
      buyerId:
        example: "0"
        type: string
      goodsId:
        type: integer
      phone:
        type: string
      place:
        type: string
      state:
        type: integer
      time:
        type: integer
    type: object
  model.RelationJson:
    properties:
      goodsId:
        type: integer
      owner:
        example: "0"
        type: string
      target:
        example: "0"
        type: string
      type:
        type: integer
    type: object
  model.User:
    properties:
      avatar:
        type: string
      name:
        type: string
      phone:
        type: string
      sign:
        type: string
      uid:
        example: "0"
        type: string
      vid:
        type: string
    type: object
  model.UserJson:
    properties:
      avatar:
        type: string
      name:
        type: string
      phone:
        type: string
      sign:
        type: string
      uid:
        example: ""
        type: string
      vid:
        type: string
    type: object
  response.Response:
    properties:
      code:
        type: integer
      data: {}
      message:
        type: string
    type: object
info:
  contact: {}
  description: 一个基于微信小程序的校园二手交易平台的api文档
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: http://swagger.io/terms/
  title: 二手交易
  version: "1.0"
paths:
  /appraise/{page}/{pageSize}:
    get:
      parameters:
      - description: 页数
        in: path
        name: page
        required: true
        type: integer
      - description: 一页的大小
        in: path
        name: pageSize
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 分页获取评论信息
      tags:
      - 评论模块
  /appraise/create:
    post:
      parameters:
      - description: 评价信息
        in: body
        name: json
        required: true
        schema:
          $ref: '#/definitions/model.AppraiseJson'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 创建评论
      tags:
      - 评论模块
  /appraise/delete/{id}:
    delete:
      parameters:
      - description: 评论id
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 删除评论
      tags:
      - 评论模块
  /appraise/revise:
    post:
      parameters:
      - description: 评价信息
        in: body
        name: json
        required: true
        schema:
          $ref: '#/definitions/model.Appraise'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 修改评论
      tags:
      - 评论模块
  /appraise/user:
    get:
      parameters:
      - description: 用户id
        in: query
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取用户评价
      tags:
      - 评论模块
  /category:
    get:
      consumes:
      - application/json
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取所有分类
      tags:
      - 分类模块
  /category/create:
    post:
      consumes:
      - application/json
      parameters:
      - description: 分类数据
        in: body
        name: json
        required: true
        schema:
          $ref: '#/definitions/model.CategoryJson'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 创建分类
      tags:
      - 分类模块
  /category/delete/{id}:
    delete:
      parameters:
      - description: 分类id
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 根据分类id删除某个分类
      tags:
      - 分类模块
  /chat:
    get:
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 与服务端进行websocket连接，请使用postman测试
      tags:
      - 聊天模块
  /chat/from/{page}/{pageSize}:
    get:
      parameters:
      - description: 页数
        in: path
        name: page
        required: true
        type: integer
      - description: 一页的大小
        in: path
        name: pageSize
        required: true
        type: integer
      - description: 用户id
        in: query
        name: uid
        required: true
        type: string
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取未过期且来源为特定用户的聊天记录
      tags:
      - 聊天模块
  /chat/latest:
    get:
      parameters:
      - description: 用户id
        in: query
        name: uid
        required: true
        type: string
      - description: 对象id
        in: query
        name: target
        required: true
        type: string
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取与特定用户相关的最后一条聊天记录
      tags:
      - 聊天模块
  /chat/msg:
    get:
      parameters:
      - description: 用户id
        in: query
        name: uid
        required: true
        type: string
      - description: 对象id
        in: query
        name: target
        required: true
        type: string
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取与特定两个用户之间的所有聊天记录
      tags:
      - 聊天模块
  /chat/to/{page}/{pageSize}:
    get:
      parameters:
      - description: 页数
        in: path
        name: page
        required: true
        type: integer
      - description: 一页的大小
        in: path
        name: pageSize
        required: true
        type: integer
      - description: 用户id
        in: query
        name: uid
        required: true
        type: string
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取未过期且目标为特定用户的聊天记录
      tags:
      - 聊天模块
  /goods/{page}/{pageSize}:
    get:
      parameters:
      - description: 页数
        in: path
        name: page
        required: true
        type: integer
      - description: 一页的大小
        in: path
        name: pageSize
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取所有商品
      tags:
      - 商品模块
  /goods/category/{page}/{pageSize}:
    get:
      parameters:
      - description: 页数
        in: path
        name: page
        required: true
        type: integer
      - description: 一页的大小
        in: path
        name: pageSize
        required: true
        type: integer
      - description: 商品分类id
        in: query
        name: category
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 按分类查找商品并分页显示
      tags:
      - 商品模块
  /goods/create:
    post:
      consumes:
      - application/json
      parameters:
      - description: 商品信息
        in: body
        name: json
        required: true
        schema:
          $ref: '#/definitions/model.GoodsJson'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 创建商品
      tags:
      - 商品模块
  /goods/delete/{id}:
    delete:
      parameters:
      - description: 商品id
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 删除商品
      tags:
      - 商品模块
  /goods/detail/{id}:
    get:
      parameters:
      - description: 商品id
        in: path
        name: id
        required: true
        type: integer
      - description: 访问的用户id
        in: query
        name: uid
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取商品详细信息
      tags:
      - 商品模块
  /goods/list:
    post:
      parameters:
      - description: 商品id列表
        in: body
        name: id
        required: true
        schema:
          items:
            type: string
          type: array
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 批量获取商品信息
      tags:
      - 商品模块
  /goods/recommend:
    get:
      parameters:
      - description: 用户id
        in: query
        name: id
        required: true
        type: integer
      - description: 推荐的数目
        in: query
        name: size
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 分页获取推荐商品
      tags:
      - 商品模块
  /goods/revise:
    post:
      parameters:
      - description: 商品信息
        in: body
        name: json
        required: true
        schema:
          $ref: '#/definitions/model.Goods'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 修改商品信息
      tags:
      - 商品模块
  /goods/search/{page}/{pageSize}:
    get:
      parameters:
      - description: 页数
        in: path
        name: page
        required: true
        type: integer
      - description: 一页的大小
        in: path
        name: pageSize
        required: true
        type: integer
      - description: 搜素关键词
        in: query
        name: keyword
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 搜索商品并分页显示
      tags:
      - 商品模块
  /goods/user/{id}:
    get:
      parameters:
      - description: 用户id
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取某个用户的所有商品
      tags:
      - 商品模块
  /order:
    get:
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取所有订单
      tags:
      - 订单模块
  /order/{page}/{pageSize}:
    get:
      parameters:
      - description: 页数
        in: path
        name: page
        required: true
        type: integer
      - description: 一页的大小
        in: path
        name: pageSize
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 分页获取订单
      tags:
      - 订单模块
  /order/create:
    post:
      parameters:
      - description: 订单信息
        in: body
        name: json
        required: true
        schema:
          $ref: '#/definitions/model.OrderJson'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 创建订单
      tags:
      - 订单模块
  /order/delete/{id}:
    delete:
      parameters:
      - description: 订单id
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 删除订单
      tags:
      - 订单模块
  /order/revise:
    post:
      parameters:
      - description: 订单id
        in: formData
        name: id
        required: true
        type: integer
      - description: 订单状态
        in: formData
        name: state
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 修改订单的状态
      tags:
      - 订单模块
  /order/user:
    get:
      parameters:
      - description: 用户id
        in: query
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取用户的所有订单
      tags:
      - 订单模块
  /pic:
    get:
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取所有图片
      tags:
      - 图片模块
  /pic/{page}/{pageSize}:
    get:
      parameters:
      - description: 页数
        in: path
        name: page
        required: true
        type: integer
      - description: 一页的大小
        in: path
        name: pageSize
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 分页获取图片
      tags:
      - 图片模块
  /pic/delete/{id}:
    delete:
      parameters:
      - description: 图片id
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 删除图片
      tags:
      - 图片模块
  /pic/upload:
    post:
      consumes:
      - multipart/form-data
      parameters:
      - description: 图片
        in: formData
        name: pic
        required: true
        type: file
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 上传图片
      tags:
      - 图片模块
  /relation/{page}/{pageSize}:
    get:
      parameters:
      - description: 页数
        in: path
        name: page
        required: true
        type: integer
      - description: 一页的大小
        in: path
        name: pageSize
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 分页用户关系
      tags:
      - 用户关系模块
  /relation/bad:
    get:
      parameters:
      - description: 用户id
        in: query
        name: uid
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 传入用户id获取用户黑名单列表
      tags:
      - 用户关系模块
  /relation/create:
    post:
      consumes:
      - application/json
      parameters:
      - description: 关系数据
        in: body
        name: json
        required: true
        schema:
          $ref: '#/definitions/model.RelationJson'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 添加用户间的关系，关系类型有1:好友关系，2:黑名单关系
      tags:
      - 用户关系模块
  /relation/delete/{id}:
    delete:
      parameters:
      - description: 关系id
        in: path
        name: id
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 根据关系id删除关系
      tags:
      - 用户关系模块
  /relation/friend:
    get:
      parameters:
      - description: 用户id
        in: query
        name: uid
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 传入用户id获取用户好友列表
      tags:
      - 用户关系模块
  /user/{page}/{pageSize}:
    get:
      parameters:
      - description: 页数
        in: path
        name: page
        required: true
        type: integer
      - description: 一页的大小
        in: path
        name: pageSize
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 分页用户信息
      tags:
      - 用户模块
  /user/info:
    get:
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 获取用户信息
      tags:
      - 用户模块
  /user/list:
    post:
      parameters:
      - description: 用户id列表
        in: body
        name: uid
        required: true
        schema:
          items:
            type: string
          type: array
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 批量获取用户信息
      tags:
      - 用户模块
  /user/login:
    post:
      parameters:
      - description: 微信ID
        in: formData
        name: vid
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 登录
      tags:
      - 用户模块
  /user/modify:
    post:
      consumes:
      - application/json
      parameters:
      - description: 用户信息
        in: body
        name: json
        required: true
        schema:
          $ref: '#/definitions/model.User'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 修改用户信息
      tags:
      - 用户模块
  /user/rec/new:
    post:
      parameters:
      - description: 推荐信息
        in: body
        name: data
        schema:
          $ref: '#/definitions/controller.NewRec'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 初始化用户推荐数据
      tags:
      - 用户模块
  /user/register:
    post:
      consumes:
      - application/json
      parameters:
      - description: 用户信息
        in: body
        name: json
        required: true
        schema:
          $ref: '#/definitions/model.UserJson'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/response.Response'
      summary: 创建用户
      tags:
      - 用户模块
swagger: "2.0"