ascle.yaml

swagger: '2.0'
info:
  title: ASCLE API
  version: 1.0.0
host: doctor.hotfix.gengmei.cc
schemes:
  - http
basePath: /api/web
paths:
  /account/user:
    get:
      summary: 用户信息
      description: 用户信息
      tags:
        - Account
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                doctor:
                  department: 美容外科
                  phone: '15288842299'
                  accept_reserve: true
                  name: 王飏
                  portrait: http://wanmeizhensuo.qiniudn.com/2015/02/14/9c808ed226
                  introduction: introduction
                  good_at: g123
                  id: wangyang
                  title: 主治医师
                  is_online: false
                user:
                  in_blacklist: false
                  phone: '12345678912'
                  address: ''
                  id: 602329
                  portrait: http://wanmeizhensuo.qiniudn.com/2015/02/14/9c808ed226
                  city: 台北
                  real_name: ''
                  nick_name: 王飏 医生
                hospital:
                  name: 济南鹏爱整形美容医院
                  id: jnpayl
              error: 0
              message: ''
    post:
      summary: 修改用户信息
      description: 修改用户信息
      consumes:
        - application/x-www-form-urlencoded
      parameters:
        - name: good_at
          in: formData
          description: 擅长,不能超过14个字
          required: true
          type: string
          format: string
        - name: introduction
          in: formData
          description: 个人简介
          required: true
          type: string
          format: string
      tags:
        - Account
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data:

# ------------------------
  /account/captcha:
    get:
      summary: 图片验证码
      description: |
        展示图片验证码
      tags:
        - Account
      responses:
        '200':
          description: ok
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data:
# ------------------------
  /account/login:
    post:
      summary: 登录
      description: 登录
      consumes:
        - application/x-www-form-urlencoded
      parameters:
        - name: name
          in: formData
          description: 用户手机号（以后可能会是邮箱等）
          required: true
          type: string
          format: string
        - name: method
          in: formData
          description: 登录方式.
          required: true
          type: string
          format: string
        - name: password
          in: formData
          description: 密码.（密码，验证码必有一个）
          required: false
          type: string
          format: string
        - name: authcode
          in: formData
          description: 验证码.
          required: false
          type: string
          format: string
      tags:
        - Account
      responses:
        '200':
          description: ok
          schema: {}
          examples:
            application/json:
              data:
                doctor:
                  department: 美容外科
                  phone: '15288842299'
                  accept_reserve: true
                  name: 王飏
                  portrait: http://wanmeizhensuo.qiniudn.com/2015/02/14/9c808ed226
                  introduction: introduction
                  id: wangyang
                  title: 主治医师
                  is_online: false
                user:
                  in_blacklist: false
                  phone: '12345678912'
                  address: ''
                  id: 602329
                  portrait: http://wanmeizhensuo.qiniudn.com/2015/02/14/9c808ed226
                  city: 台北
                  real_name: ''
                  nick_name: 王飏 医生
                hospital:
                  name: 济南鹏爱整形美容医院
                  id: jnpayl
              error: 0
              message: ''
# ------------------------
  /account/logout:
    post:
      summary: 登录出去
      description: 登录出去
      consumes:
        - application/x-www-form-urlencoded
      tags:
        - Account
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data: null
# ------------------------
  /account/code:
    post:
      summary: 发送手机验证码
      description: 未登录情况下，发送手机验证码
      consumes:
        - application/x-www-form-urlencoded
      tags:
        - Account
      parameters:
        - name: type
          in: formData
          description: 要求发送的类型(1,登陆)  (4,提交注册)
          required: true
          type: integer
          format: integer
        - name: phone
          in: formData
          description: 手机号
          required: true
          type: integer
          format: integer
        - name: image_code
          in: formData
          description: 验证码
          required: true
          type: integer
          format: integer
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data: null
  /account/code/online:
    post:
      summary: 登陆之后,发送手机验证码
      description: 登陆之后，发送手机验证码(只在更改密码的时候需要,不需要任何参数)
      consumes:
        - application/x-www-form-urlencoded
      tags:
        - Account
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data: null
# ------------------------
  /account/password:
    post:
      summary: 更改密码
      description: 更改密码
      consumes:
        - application/x-www-form-urlencoded
      tags:
        - Account
      parameters:
        - name: new_password
          in: formData
          description: 新密码
          required: true
          type: string
          format: string
        - name: code
          in: formData
          description: 手机验证码
          required: true
          type: integer
          format: integer
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data: null
# ------------------------
  /agreement/{id}:
    get:
      summary: 协议详情
      description: 获得单个协议的详情
      tags:
        - Agreement
      parameters:
        - name: id
          in: path
          description: 协议id
          required: true
          type: integer
          format: integer

      responses:
        '200':
          description: An array of price estimates by product
          schema: {}
          examples:
            application/json:
              data:
                status: 1
                title: 0123456789012345
                content: 阿斯蒂芬
                agree_time: 1470416242
                id: 2
              error: 0
              message: ''
# ------------------------
  /agreement/{id}/accept:
    post:
      summary: 接受协议
      description: 医生点击同意协议
      consumes:
        - application/x-www-form-urlencoded
      parameters:
        - name: id
          in: path
          description: 协议id
          required: true
          type: integer
          format: integer

      tags:
        - Agreement
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data: null
# ------------------------
  /agreement/no_accepted:
    get:
      summary: 没有接受的协议列表
      description: 直接返回所有还没有接受的协议
      tags:
        - Agreement
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
              - send_time: 1470137721
                content: zcxklvnkj.bfak.wbf分爱死了的女阿克苏的那款那棵树的部分款
                title: 第三个
                id: 3
              - send_time: 1470137721
                content: 阿斯蒂芬
                title: 012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678
                id: 2
              error: 0
              message: ''
# ------------------------
  /agreement:
    get:
      summary: 接受的协议列表
      description: 按照分页返回协议列表
      parameters:
        - name: page
          in: query
          description: 请求第几页的数据，默认为1
          required: false
          type: integer
          format: integer
      tags:
        - Agreement
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                accepted_list:
                - send_time: 1470137721
                  agree_time: 1470137721
                  content: zcxklvnkj.bfak.wbf分爱死了的女
                  title: 第三个
                  id: 3
                - send_time: 1470137721
                  agree_time: 1470137721
                  content: 阿斯蒂芬
                  title: 012345678901234567890123
                  id: 2
                size: 10
                total: 3
                page: 1
              error: 0
              message: ''
# ------------------------
  /bulletin:
    get:
      summary: 公告列表
      description: 医生公告列表
      parameters:
        - name: page
          in: formData
          description: 第几页,默认为1
          required: false
          type: integer
          format: integer
      tags:
        - bulletin
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data:
                page: 1
                size: 10
                total: 3
                bulletints:
                  - date: 1458730446
                    image: 'http://hera.s.gmei.com/bulletin/2016/03/23/b3e00f8825'
                    title: 我的第一个公告
                    content_id: 2
# ------------------------
  /bulletin/{id}:
    get:
      summary: 公告详情
      description: 医生公告详情
      tags:
        - bulletin
      parameters:
        - name: id
          in: path
          description: 公告ID
          required: true
          type: integer
          format: integer
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                date: 1458730446
                image: 'http://hera.s.gmei.com/bulletin/2016/03/23/b3e00f8825'
                title: 我的第一个公告
                content_id: 2
              message: ''
              error: 0
# ------------------------
  /switch:
    get:
      summary: 可切换医生列表
      description: 可切换医生列表
      tags:
        - Switch
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                total: 2
                message: ''
                page: 1
                doctors:
                  - id: 123
                    name: 医生1号
                  - id: 123
                    name: 医生2号
              message: ''
              error: 0
# ------------------------
  /switch/{id}:
    get:
      summary: 用户切换
      description: 用户切换
      parameters:
        - name: id
          in: path
          description: 用户ID
          required: true
          type: integer
          format: integer

      tags:
        - Switch
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                doctor:
                  department: 美容外科
                  phone: '15288842299'
                  accept_reserve: true
                  name: 王飏
                  portrait: http://wanmeizhensuo.qiniudn.com/2015/02/14/9c808ed226
                  introduction: introduction
                  id: wangyang
                  title: 主治医师
                  is_online: false
                user:
                  in_blacklist: false
                  phone: '12345678912'
                  address: ''
                  id: 602329
                  portrait: http://wanmeizhensuo.qiniudn.com/2015/02/14/9c808ed226
                  city: 台北
                  real_name: ''
                  nick_name: 王飏 医生
                hospital:
                  name: 济南鹏爱整形美容医院
                  id: jnpayl
              message: ''
              error: 0
    parameters:
      - name: id
        in: path
        description: 对帐单ID
        required: true
        type: integer
        format: integer
# ------------------------
  /order:
    get:
      summary: 订单列表
      description: 订单列表
      parameters:
        - name: statement_id
          in: query
          description: 对帐单ID
          required: false
          type: integer
          format: integer
        - name: status
          in: query
          description: 状态
          required: false
          type: string
          format: string
        - name: page
          in: query
          description: 页码
          required: false
          type: integer
          format: integer
        - name: order_by
          in: query
          description: 排序字段
          required: false
          type: string
          format: string
        - name: key
          in: query
          description: 搜索字段
          required: false
          type: string
          format: string
      tags:
        - Order
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                total: 2
                message: ''
                page: 1
                orders:
                  - name: m型唇
                    status: '已退款'
                    created_time: 1472900054
                    item: ''
                    pre_payment_price: 1
                    hospital_payment: 0
                    validate_time: 1470394763
                    id: '3138635937'
                    gengmei_price: 1
                  - name: 【北京@刘浩】test003专用测试，请勿修改或删除，谢谢合作！
                    status: '已验证'
                    created_time: 1470160559
                    item: '[u''R'', u''32'']'
                    pre_payment_price: 2
                    hospital_payment: 331
                    validate_time: 1470160719
                    id: '4626252114'
                    gengmei_price: 333
              message: ''
              error: 0
  /order/validate:
    post:
      summary: 订单验证
      description: 订单验证
      consumes:
        - application/x-www-form-urlencoded

      parameters:
        - name: order_id
          in: formData
          description: 订单ID
          required: false
          type: integer
          format: integer
        - name: password
          in: formData
          description: 订单验证码
          required: true
          type: integer
          format: integer
      tags:
        - Order
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data: None
              message: ''
              error: 0
# ------------------------
  /order/{id}:
    get:
      summary: 订单详情
      description: 订单详情
      parameters:
        - name: id
          in: path
          description: 订单ID
          required: true
          type: integer
          format: integer

      tags:
        - Order
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                id: 123
                service_id: 234
                service_name: '美购名称'
                items: '实际购买属性'
                gengmei_price: 234
                pre_payment_price: 123
                hospital_payment: 111
                user_name: '小嬛嬛'
                phone: 18742441012
                created_time: 1470160559
                validate_time: 1470160559 or None
                validated: 0 or 1
              message: ''
              error: 0
    parameters:
      - name: id
        in: path
        description: 订单ID
        required: true
        type: integer
        format: integer
# ------------------------
  /refund:
    get:
      summary: 退款单列表
      description: 退款单列表
      parameters:
        - name: status
          in: query
          description: 状态
          required: false
          type: string
          format: string
        - name: order_by
          in: query
          description: 排序字段
          required: false
          type: string
          format: string
        - name: key
          in: query
          description: 搜索字段
          required: false
          type: string
          format: string
        - name: page
          in: query
          description: 页码
          required: false
          type: integer
          format: integer
      tags:
        - Refund
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              total: 2
              message: ''
              page: 1
              error: 0
              orders:
                - name: m型唇
                  status: '已退款'
                  created_time: 1472900054
                  items: ''
                  pre_payment_price: 1
                  hospital_payment: 0
                  refund_time: 1470394763
                  id: '3138635937'
                  order_id: 3138635937
                  gengmei_price: 1
                - name: 【北京@刘浩】test003专用测试，请勿修改或删除，谢谢合作！
                  status: '已验证'
                  created_time: 1470160559
                  items: '多属性名称'
                  pre_payment_price: 2
                  hospital_payment: 331
                  refund_time: 1470160719
                  id: '4626252114'
                  order_id: 3138635937
                  gengmei_price: 333
# ------------------------
  /refund/{id}:
    get:
      summary: 退款单详情
      description: 退款单详情
      tags:
        - Refund
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                id: 123
                order_id: 123
                service_id: 234
                service_name: '美购名称'
                items: '实际购买属性'
                gengmei_price: 234
                pre_payment_price: 123
                hospital_payment: 111
                user_name: '小嬛嬛'
                phone: 18742441012
                created_time: 1470160559
                refund_time: 1470160559 or None
                refunded_time: 1470160559 or None
                validated: 0 or 1
              message: ''
              error: 0
    parameters:
      - name: id
        in: path
        description: 对帐单ID
        required: true
        type: integer
        format: integer
# ------------------------
  /refund/{id}/agree:
    post:
      summary: 同意退款
      description: 同意退款
      consumes:
        - application/x-www-form-urlencoded

      tags:
        - Refund
      responses:
        '200':
          description: OK
    parameters:
      - name: id
        in: path
        description: 对帐单ID
        required: true
        type: integer
        format: integer
# ------------------------
  /statement:
    get:
      summary: 对帐单列表
      description: 对帐单列表
      parameters:
        - name: order_by
          in: query
          description: 排序字段
          required: false
          type: string
          format: string
        - name: page
          in: query
          description: 页码
          required: false
          type: integer
          format: integer
      tags:
        - Statement
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                total: 10
              message: ''
              error: 0
# ------------------------
  /statement/{id}:
    get:
      summary: 对帐单详情
      description: 对帐单详情
      tags:
        - Statement
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                feededuction_sum: 补扣款总额
                settle_price: 结算金额
                poundage: 手续费
                pre_payment_price: 预付款总额
                bank: 开户银行
                account_number: 账号
                account_name: 户名
              message: ''
              error: 0
    parameters:
      - name: id
        in: path
        description: 对帐单ID
        required: true
        type: integer
        format: integer
# ------------------------
  /statement/{id}/operation:
    get:
      summary: 对帐单日志
      description: 对帐单日志
      tags:
        - Statement
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                operations:
                  - operate_time: 1469458933
                    operator: "系统"
                    id: 6427
                    optype: "生成对账单"
                  - operate_time: 1469458933
                    operator: "系统"
                    id: 6427
                    optype: "生成对账单"
              message: ''
              error: 0
    parameters:
      - name: id
        in: path
        description: 对帐单ID
        required: true
        type: integer
        format: integer
# ---------------------------------
  /statement/{id}/deduction:
    get:
      summary: 对帐单扣款明细
      description: 对帐单扣款明细
      tags:
        - Statement
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                deductions:
                  - value: 123
                    comment: '罚你钱'
                  - value: 123
                    comment: '罚你钱'
                replenishment:
                  - value: 123
                    comment: '补你钱'
              message: ''
              error: 0
    parameters:
      - name: id
        in: path
        description: 对帐单ID
        required: true
        type: integer
        format: integer
# ------------------------
  /service/<tag_id>/template:
    get:
      summary: 美购模板
      description: 返回后台设置好的美购属性表，
      parameters:
        - name: tag_id
          in: path
          description: 项目/tag id
          required: true
          type: integer
          format: integer
      tags:
        - Service
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              message: ''
              error: 0
              data:
                - id: 属性id
                  name: 属性name
                  options:
                    - name: 选项
                      id: 选项id
                    - name: 选项
                      id: 选项id
# ------------------------
# ------------------------
  /service/status:
    post:
      summary: 发送上下线请求
      parameters:
        - name: type
          in: query
          description: 上线或是下线,使用gaia SERVICE_REVIEW_TYPE 2上线，3下线
          required: true
          type: integer
          format: integer
        - name: id
          in: query
          description: 申请美购的 id
          required: true
          type: integer
          format: integer
      tags:
        - Service
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              message: ''
              error: 0
              data: null
# ------------------------
  /service/review:
    get:
      summary: 重构美购审核状态列表
      description: 两类，6种类型的待审核列表都通过这个
      parameters:
        - name: type
          in: query
          description: 标识是那种类型,通过不通过各有三种,一共6中，ascle_type里有
          required: true
          type: integer
          format: integer
        - name: q
          in: query
          description: 过滤关键词,默认不过滤
          required: false
          type: string
          format: string
        - name: ask_all_counts
          in: query
          description: 是否需要全部的数字,默认不需要,传true or false
          required: false
          type: boolean
          format: boolean
        - name: page
          in: query
          description: 第几页,默认第一页
          required: false
          type: integer
          format: integer
      tags:
        - Service
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              message: ''
              error: 0
              data:
                size: 10
                total_counts: list内含1或3元素
                services:
                  - short_description: 美购描述
                    id: 21美购申请id
                    submit_time: 提交时间
                    status: 状态码，int
                    bar_status: 这条记录从属那个bar
# ----Skyler start--------------------
  /service:
    get:
      summary: 美购列表
      description: 经营管理--美购销量; 项目管理--项目列表
      parameters:
        - name: page
          in: query
          description: 分页
          required: false
          type: integer
          format: integer
        - name: order_by
          in: query
          description: 排序字段
          required: false
          type: integer
          format: integer
      tags:
        - Service
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                total: 100
                page: 1
                size: 10
                services:
                  - service_name: 美购名称
                    gengmei_price: 2200
                    pre_payment_price: 200
                    hospital_payment: 2000
                    sell_amount: 100
                    used_amount: 1
                    refunded_amount: 1
                    refunded_rate: 1%
                    is_multiattribute: false
                    is_online: true
                    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
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data:
                short_description: '[玻尿酸注射] 这是一个美购的信息'
                start_time: 134949595
                end_time: 1433442234
                reservation: 3
                total_num: 30
                left_num: 12
                project_type: 12
                image_header: 'http://...'
                photo_details: 'blabla...'
                is_specialreview: false
                items: '[#json序列化化的数据
                    {
                        service_register: 32,
                        key: "84-85",
                        pre_payment_price_int: 0,
                        gengmei_price: 76545,
                        original_price: 876543,
                        cash_back_rate: 5,
                        points_deduction_percent: 10,
                        option_ids: [],
                        discount: 0,
                        pre_payment_price: 7,
                        is_online: true,
                        seckill_price: 999999,
                        sort: 99999,
                        serviceregisteritemkey: null,
                        cash_back_fee: 0,
                        id: 63
                    }]'
    post:
      summary: 编辑或新建美购
      description: 编辑或新建美购
      parameters:
        - name: register_id
          in: path
          description: 上传美购ID
          required: false
          type: integer
          format: integer
        - name: short_description
          in: formData
          description: 美购详情一句话描述
          required: false
          type: string
          format: string
        - name: start_time
          in: formData
          description: 美购开始时间
          required: false
          type: integer
          format: integer
        - name: end_time
          in: formData
          description: 美购结束售卖时间
          required: false
          type: integer
          format: integer
        - name: reservation
          in: formData
          description: 提前预约天数
          required: false
          type: integer
          format: integer
        - name: total_num
          in: formData
          description: 总数
          required: false
          type: integer
          format: integer
        - name: image_header
          in: formData
          description: 美购图片
          required: false
          type: string
          format: string
        - name: num_change
          in: formData
          description: 美购总量变动
          required: false
          type: integer
          format: integer
        - name: items
          in: formData
          description: 美购价格列表
          required: false
          type: string
          format: string
        - name: upload_button
          in: formData
          description: 秒杀美购上传按钮id, 就是当前秒杀id
          required: false
          type: string
          format: string
        - name: photo_details
          in: formData
          description: 图文详情
          required: false
          type: string
          format: string
        - name: is_specialreview
          in: formData
          description: 是否特批
          required: false
          type: boolean
          format: boolean
        - name: project_type
          in: formData
          description: 项目ID
          required: true
          type: integer
          format: integer
      tags:
        - Service
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data:
                short_description: '[玻尿酸注射] 这是一个美购的信息'
                project_type: 12
                start_time: 134949595
                end_time: 1433442234
                reservation: 3
                total_num: 30
                image_header: 'http://...'
                photo_details: 'blabla...'
                is_specialreview: false
                items: '[#json序列化化的数据
                    {
                        option_ids: [1,3,4],
                        order: 1
                        market_price: 11223,
                        gengmei_price: 12233,
                        is_online: true
                    }]'

# ------------------------
  /search/topic:
    get:
      summary: 帖子列表
      description: 搜索帖子列表, 搜正常的，公共的，在线的，咨询类的，tag相关的话题，根据时间降序排列
      parameters:
        - name: page
          in: query
          description: 分页
          required: false
          type: integer
          format: integer
        - name: tag_id
          in: query
          description: 标签 id, 数据从 /tag 获取
          required: false
          type: integer
          format: integer
        - name: query
          in: query
          description: 过滤关键词？
          required: false
          type: string
          format: string
      tags:
        - Topic
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                total: 1235
                size: 10
                page: 1
                topics:
                  - title: '颜医生，请问玻尿酸丰下巴怎样收费'
                    doctor_num: 4
                    user_name: '变美不为男人'
                    city: '北京'
                    date: 145678345
                    id: 12177395
              error: 0
              message: ""

  /search/reply:
    get:
      summary: 用户回复列表
      description: 搜用户相关的，非私信类的话题，根据帖子权重和最后修改时间降序排列
      parameters:
        - name: page
          in: query
          description: 分页
          required: false
          type: integer
          format: integer
      tags:
        - Topic
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                page: 1
                size: 10
                total: 1235
                topics:
                  - title: '颜医生，请问玻尿酸丰下巴怎样收费'
                    doctor_num: 4
                    user_name: '变美不为男人'
                    city: '北京'
                    score: 3
                    date: 145678345
                    id: 12177395
              error: 0
              message: ""


  /tag:
    get:
      summary: 获取查询标签
      description: 用于查询帖子列表的tags, 一次性返回所有 一级上线的标签
      tags:
        - Topic
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              message: ''
              error: 0
              data:
                - name: 眼睛
                  id: 123

  /topic/{topic_id}:
    get:
      summary: 帖子详情
      description: 帖子详情
      parameters:
        - name: topic_id
          in: path
          description: 帖子ID
          required: true
          type: integer
          format: integer
      tags:
        - Topic
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              message: ''
              error: 0
              data:
                date: 145566543
                vote_num: 2
                portrait: "http://imgcdn.wanmeizhensuo.com/user/icon10@2x.png"
                user_id: 1964249
                content: '本人鼻翼比较宽，想微整。可又担心'
                city: '广州'
                is_favord: false
                id: 898774
                user_name: '小美'
                is_safe: false
                title: ''
                images:
                  - desc: '现在'
                    image_thumb: "http://pic.gengmei.cc/2015/05/25/35fe857608-web"
                    image: "http://pic.gengmei.cc/2015/05/25/35fe857608-w"
                tags:
                  - name: '双眼皮'
                    tag_id: 15


  /topic/{topic_id}/reply:
    get:
      summary: 帖子回复
      description: 获得帖子回复列表
      parameters:
        - name: topic_id
          in: path
          description: 帖子ID
          required: true
          type: integer
          format: integer
        - name: page
          in: query
          description: 请求第几页的数据，默认为1
          required: false
          type: integer
          format: integer
      tags:
        - Topic
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              message: ''
              error: 0
              data:
                - user_nickname: "王飏"
                  content: "hehe \n您提供的照片不符合标准，无法给出具体建议，建议上传……"
                  reply_id: 12048264
                  user_type: 2
                  user_id: "newhos11161827"
                  user_portrait: "http://wanmeizhensuo.qiniudn.com/2015/02/14/9c808ed226"
                  is_liked: false
                  favor_amount: 0
                  is_best_reply: false
                  comments:
                    - comment_id: 12048265
                      content: "hehehe您的问题难以准确回答，建议咨询您的手术医生……"
                      comment_user_id: "newhos11161827"
                      nickname: "王飏医生"
                      at_user_type: 0
                      at_user_id: 602329
                      at_nickname: ""
                      is_best_reply: false
                      comment_user_type: 2
                  reply_date: 128833445
    post:
      summary: 动词回复
      description: 回复话题或者回复别人的回复
      consumes:
        - application/x-www-form-urlencoded
      parameters:
        - name: topic_id
          in: path
          description: 地址里的帖子ID
          required: true
          type: integer
          format: integer
        - name: id
          in: formData
          description: 被回复着的id,如果是针对话题不需要
          required: false
          type: integer
          format: integer
        - name: content
          in: formData
          description: 回复的内容
          required: true
          type: string
          format: string
      tags:
        - Topic
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              data:
                comment_data:
                  comment_user_type: ''
                  reply_id: 11793547
                  content: mio啥地方环境是
                  comment_id: 11793550
                  at_nickname: ''
                  at_user_id: 602329
                  at_user_type: 1
                  comment_user_id: 602329
                  nickname: 王飏 医生
                point_number: false
                topic:
                  ask: ''
                  id: 595298
                doctor:
                  id: wangyang
                  today_reply_count: 1
                reply_data:
                  reply_id: 11793550
                  comments: []
                  user_id: wangyang
                  content: mio啥地方环境是
                  reply_date: 今天
                  reply_timestamp: 1471879815
                  user_type: 1
                  user_nickname: 王飏 医生
                  user_portrait: http://wanmeizhensuo.qiniudn.com/2015/02/14/9c808ed226-thumb
              message: ''

  /topic/{topic_id}/sink:
    post:
      summary: 话题下沉
      description: 更改话题分值，话题往后排
      consumes:
        - application/x-www-form-urlencoded
      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
        - name: keyword
          in: query
          description: 搜索的关键词
          required: false
          type: string
          format: string
      tags:
        - Conversation
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              message: ''
              error: 0
              data:
                size: 10
                page: 1
                total: 6
                conversations:
                  - 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/{user_key}:
    get:
      summary: 私信详情
      description: 私信详情
      parameters:
        - name: user_key
          in: path
          description: 私信用户标识
          required: true
          type: integer
          format: integer
      tags:
        - Conversation
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ""
              data:
                target_uid: 20299931
                is_new: 0
                nickname: '更美用户summer'
                order_info:
                  refund:
                    message: '该用户完成了您的退款'
                    time: '2016-06-18 18:06'            # 注意，这里先不用时间戳
                  service:
                    image: 'http://hera.s.gmei.com/2016/05/27/5585042b46'
                    title: "【北京@陈丽芳】韩式半永久纹眉"
                    gengmei_price: 1
                    hospital_price: 0
                    pre_payment_price: 1
                    message: '该用户购买了您的美购'
                results:
                  - id: 2936562
                    user_key: "111549_602329"
                    audio: ""
                    portrait: "http://pic.gengmei.cc/2015/09/01/e587955d7f-thumb"
                    uid: 111549
                    nickname: "发疯了的猫"
                    reply_time: 145665544
                    type: "0"
                    image: ""
                    image_thumb: ""
                    text: "干嘛"
                    send_time: 113345455
                    doctor_id: ""
    post:
      summary: 回复私信
      description: 回复私信
      consumes:
        - application/x-www-form-urlencoded
      parameters:
        - name: user_key
          in: path
          description: 私信用户标识
          required: true
          type: integer
          format: integer
        - name: type
          in: formData
          description: 回复类型, 填 0， 表示文字，语音图像什么的以后再说
          required: true
          type: integer
          format: integer
        - name: content
          in: formData
          description: 回复内容
          required: true
          type: string
      tags:
        - Conversation
      responses:
        '200':
          description: OK
# ------------------------
  /conversation/{conversation_id}/sink:
    post:
      summary: 私信下沉
      description: 私信私信下沉
      parameters:
        - name: conversation_id
          in: path
          description: conversation list 里的id,标识会话
          required: true
          type: integer
          format: integer
      tags:
        - Conversation
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ""
              data: null
# ------------------------
  /reserve:
    get:
      summary: 预约列表
      description: 预约列表
      parameters:
        - name: page
          in: query
          description: 分页
          required: false
          type: integer
          format: integer
      tags:
        - Reserve
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                total: 100
                page: 1
                size: 10
                reserves:
                  - timestamp: 1458730446
                    date: YYYY-mm-DD
                    time: HH:MM
                    status: 0
                    type: 1
                    type_desc: 面诊
                    address: 北京医院
                    service_name: 美购名称
                    user_name: 用户名称
                    user_key: "12334_33223"
              message: ''
              error: 0
# ------------------------
  /reserve/{id}/set_status:
    post:
      summary: 确认/取消预约
      description: 确认/取消预约
      consumes:
        - application/x-www-form-urlencoded
      parameters:
        - name: id
          in: path
          description: 对帐单ID
          required: true
          type: integer
          format: integer
        - name: status
          in: formData
          description: 2--} 确认; 3--} 取消
          required: true
          type: integer
          format: integer
      tags:
        - Reserve
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              message: ''
              error: 0
# ------------------------
  /address:
    get:
      summary: 医生地址列表
      description: 医生地址列表
      tags:
        - Address
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                adresses:
                  - id: 1458730446
                    desc: 地址描述
              message: ''
              error: 0
# ------------------------
  /address/create:
    post:
      summary: 添加地址
      description: 添加地址
      consumes:
        - application/x-www-form-urlencoded
      parameters:
        - name: lng
          in: formData
          description: 经度
          required: true
          type: string
          format: string
        - name: lat
          in: formData
          description: 纬度
          required: true
          type: string
          format: string
        - name: location
          in: formData
          description: 地址名称
          required: true
          type: string
          format: string
        - name: desc
          in: formData
          description: 地址详细
          required: true
          type: string
          format: string
      tags:
        - Address
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              message: ''
              data:
                id: 23,
                desc: 地址描述
              error: 0
# ------------------------
  /reserve/schedule:
    get:
      summary: 获取预约时间
      description: 获取预约时间
      parameters:
        - name: first_day
          in: query
          description: YYYY-mm-DD, 每周周一的day
          required: true
          type: string
          format: string
      tags:
        - Reserve
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              data:
                schedules:
                  - id: 2016-06-13
                    title: 06月13日 周一
                    am:
                      end_time: "12:00"
                      start_time: "10:00"
                      address_id: 123
                      reservation_type: 2
                      address_desc: 北京武警三院
                    pm:
                      end_time: "18:00"
                      start_time: "15:00"
                      address_id: 123
                      reservation_type: 2
                      address_desc: 北京武警三院
              message: ''
              error: 0
    post:
      summary: 设置预约时间
      description: 设置预约时间
      consumes:
        - application/x-www-form-urlencoded
      parameters:
        - name: data
          in: formData
          description: JOSNString(格式为GET请求返回的数据格式,数组数据即可)
          required: true
          type: string
          format: string
      tags:
        - Reserve
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              message: ''
              error: 0
# ----商务登录------
  /business/login:
    post:
      summary: 商务登录
      description: 商务登录
      parameters:
        - name: name
          in: formData
          description: 用户名
          required: true
          type: string
          format: string
        - name: password
          in: formData
          description: 密码
          required: true
          type: string
          format: string
      tags:
        - Business
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data:
# ----商务搜索医生列表-----
  /business/doctor:
    get:
      summary: 商务搜索自己对接的医生
      description: 商务搜索自己对接的医生
      parameters:
        - name: q
          in: query
          description: 搜索关键词
          required: false
          type: string
          format: string
      tags:
        - Business
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data:
                doctors:
                  - id: 'wangyang'
                    name: 王飏
                    hospital_name: 济南医院
# ----商务选择医生------
  /business/select:
    post:
      summary: 商务选择医生
      description: 商务选择医生
      parameters:
        - name: doctor_id
          in: formData
          description: 医生id
          required: true
          type: string
          format: string
      tags:
        - Business
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data:
# ----全局数据获取-----------
  /account/doctor_badge:
    get:
      summary: 全局数据获取
      description: 秒杀设置/预付款/(消息未读数之后做)
      tags:
        - Account
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data:
                service_setting:
                  default:
                    pre_payment_percentage: 0.2
                    deduct_a_percentage: 0.1
                  seckill:
                    pre_payment_percentage: 0.2
                    deduct_a_percentage: 0.1
# ----上传文件-------------
  /file/upload:
    post:
      summary: 上传文件
      description: 上传文件
      parameters:
        - name: file
          in: formData
          description: 选择文件
          required: true
          type: file
          format: file
        - name: img_type
          in: formData
          description: 文件用途, 详见http://git.gengmei.cc/backend/gm-upload/blob/master/gm_upload/consts.py
          required: true
          type: integer
          format: integer
      tags:
        - File
      responses:
        '200':
          description: OK
          schema: {}
          examples:
            application/json:
              error: 0
              message: ''
              data: 'full_image_url'
# ----Skyler end--------------------