描述: 添加项目分组

源码位置: ./server/controllers/group.js:12

参数:

参数名 类型 描述 必选 支持版本
group_name String 项目分组名称,不能为空
group_desc String 项目分组描述
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "_id": 4,
        "group_name": "大数据5",
        "group_desc": "大数据5"
    }
}

描述: 获取项目分组列表

源码位置: ./server/controllers/group.js:51

示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": [
        {
            "_id": 1,
            "group_name": "大数据2",
            "group_desc": "大数据2",
            "add_time": 1499244581,
            "up_time": 1499244581
        },
        {
            "_id": 2,
            "group_name": "大数据3",
            "group_desc": "大数据3",
            "add_time": 1499244588,
            "up_time": 1499244588
        },
        {
            "_id": 3,
            "group_name": "大数据4",
            "group_desc": "大数据4",
            "add_time": 1499244652,
            "up_time": 1499244652
        },
        {
            "_id": 4,
            "group_name": "大数据5",
            "group_desc": "大数据5",
            "add_time": 1499328065,
            "up_time": 1499328065
        }
    ]
}

描述: 删除项目分组

源码位置: ./server/controllers/group.js:71

参数:

参数名 类型 描述 必选 支持版本
id String 项目分组id
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "n": 1,
        "ok": 1
    }
}

描述: 更新项目分组

源码位置: ./server/controllers/group.js:102

参数:

参数名 类型 描述 必选 支持版本
id String 项目分组id
group_name String 项目分组名称
group_desc String 项目分组描述
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "n": 1,
        "nModified": 1,
        "ok": 1
    }
}

描述: 用户登录接口

源码位置: ./server/controllers/user.js:13

参数:

参数名 类型 描述 必选 支持版本
email String email名称,不能为空
password String 密码,不能为空
示例:
{
    "errcode": 0,
    "errmsg": "logout success...",
    "data": {
        "uid": 101,
        "email": "admin@admin.com",
        "username": "admin",
        "add_time": 1499762848,
        "up_time": 1499762848
    }
}

描述: 退出登录接口

源码位置: ./server/controllers/user.js:57

示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": "ok"
}

描述: 修改用户密码

源码位置: ./server/controllers/user.js:150

参数:

参数名 类型 描述 必选 支持版本
uid Number 用户ID
old_password Number 旧密码, 非admin用户必须传
password Number 新密码
示例:
./api/user/change_password

描述: 用户注册接口

源码位置: ./server/controllers/user.js:214

参数:

参数名 类型 描述 必选 支持版本
email String email名称,不能为空
password String 密码,不能为空
username String 用户名
示例:
{
    "errcode": 0,
    "errmsg": "logout success...",
    "data": {
        "uid": 101,
        "email": "admin@admin.com",
        "username": "admin",
        "add_time": 1499762848,
        "up_time": 1499762848
    }
}

描述: 获取用户列表

源码位置: ./server/controllers/user.js:276

参数:

参数名 类型 描述 必选 支持版本
pageNo Number 分页页码
pageSize Number 分页大小

描述: 获取用户个人信息

源码位置: ./server/controllers/user.js:314

参数:

参数名 类型 描述 必选 支持版本
id 用户uid

描述: 删除用户,只有admin用户才有此权限

源码位置: ./server/controllers/user.js:336

参数:

参数名 类型 描述 必选 支持版本
id 用户uid

描述: 更新用户个人信息

源码位置: ./server/controllers/user.js:360

参数:

参数名 类型 描述 必选 支持版本
username String
email String

描述: 模糊搜索用户名或者email

源码位置: ./server/controllers/user.js:396

参数:

参数名 类型 描述 必选 支持版本
q String
示例:
{
    "errcode": 200,
    "errmsg": "ok",
    "data": [
        {
            "_id": 101,
            "email": "admin@admin.com",
            "password": "3d078af947521bb4a99c93f5e089fc2ac601fa09",
            "passsalt": "qc8lnjpnbs9z1vodz4ynfjemi",
            "role": "admin",
            "add_time": 1499936103,
            "up_time": 1499936103,
            "__v": 0
        }
    ]
}

描述: 添加项目分组

源码位置: ./server/controllers/project.js:15

参数:

参数名 类型 描述 必选 支持版本
name String 项目名称,不能为空
basepath String 项目基本路径,不能为空
prd_host String 项目线上域名,不能为空。可通过配置的域名访问到mock数据
group_id Number 项目分组id,不能为空
desc String 项目描述
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "__v": 0,
        "_id": 8,
        "name": "project_a2",
        "desc": "tttttt",
        "prd_host": "project.a2.cc",
        "basepath": "/a1",
        "uid": 0,
        "group_id": 1,
        "add_time": 1499331387,
        "up_time": 1499331387,
        "members": [
            0
        ]
    }
}

描述: 添加项目成员

源码位置: ./server/controllers/project.js:77

参数:

参数名 类型 描述 必选 支持版本
id Number 项目id,不能为空
member_uid String 项目成员uid,不能为空
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "n": 1,
        "ok": 1
    }
}

描述: 删除项目成员

源码位置: ./server/controllers/project.js:109

参数:

参数名 类型 描述 必选 支持版本
id Number 项目id,不能为空
uid member_uid 项目成员uid,不能为空
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "n": 1,
        "ok": 1
    }
}

描述: 获取项目成员列表

源码位置: ./server/controllers/project.js:142

参数:

参数名 类型 描述 必选 支持版本
id Number 项目id,不能为空
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": [
        {
            "_id": 101,
            "email": "admin@admin.com",
            "role": "admin",
            "add_time": 1499932673,
            "up_time": 1499932673
        }
    ]
}

描述: 添加项目

源码位置: ./server/controllers/project.js:182

参数:

参数名 类型 描述 必选 支持版本
id Number 项目id,不能为空
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "_id": 7,
        "name": "project_a1",
        "desc": "tttttt",
        "prd_host": "project.a1.cc",
        "basepath": "/a1",
        "uid": 0,
        "group_id": 1,
        "add_time": 1499331378,
        "up_time": 1499331378,
        "__v": 0,
        "members": [
            0
        ]
    }
}

描述: 获取项目列表

源码位置: ./server/controllers/project.js:206

参数:

参数名 类型 描述 必选 支持版本
group_id Number 项目group_id,不能为空
pageNo Number 分页页码
pageSize Number 分页大小
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": [
        {
            "_id": 7,
            "name": "project_a1",
            "desc": "tttttt",
            "prd_host": "project.a1.cc",
            "basepath": "/a1",
            "uid": 0,
            "group_id": 1,
            "add_time": 1499331378,
            "up_time": 1499331378,
            "__v": 0,
            "members": [
                0
            ]
        },
        {
            "_id": 8,
            "name": "project_a2",
            "desc": "tttttt",
            "prd_host": "project.a2.cc",
            "basepath": "/a1",
            "uid": 0,
            "group_id": 1,
            "add_time": 1499331387,
            "up_time": 1499331387,
            "__v": 0,
            "members": [
                0
            ]
        }
    ]
}

描述: 删除项目

源码位置: ./server/controllers/project.js:244

参数:

参数名 类型 描述 必选 支持版本
id Number 项目id,不能为空
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "n": 1,
        "ok": 1
    }
}

描述: 编辑项目

源码位置: ./server/controllers/project.js:277

参数:

参数名 类型 描述 必选 支持版本
id Number 项目id,不能为空
name String 项目名称,不能为空
basepath String 项目基本路径,不能为空
prd_host String 项目线上域名,不能为空。可通过配置的域名访问到mock数据
desc String 项目描述
env Array 项目环境配置
env[].name String 环境名称
env[].host String 环境域名
示例:

//请求示例
{
    "id": 8,
    "env": [{
        "name": "本地开发环境",
        "domain": "http://api.quar.com"
    }],
    "desc": "yapi项目"
}

//返回示例
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "n": 1,
        "ok": 1
    }
}

描述: 模糊搜索项目名称或者组名称

源码位置: ./server/controllers/project.js:338

参数:

参数名 类型 描述 必选 支持版本
q String
示例:
{
  "errcode": 200,
  "errmsg": "ok",
  "data": {
    "project": [
      {
        "_id": 101,
        "name": "project yapi",
        "prd_host": "yapi.qunar.com",
        "basepath": "/yapi/",
        "uid": 101,
        "group_id": 193,
        "add_time": 1500013365,
        "up_time": 1500013365,
        "__v": 0,
        "env": [],
        "members": [
          "101"
        ]
      }
    ],
    "group": [
      {
        "_id": 193,
        "group_name": "yapi",
        "group_desc": "group yapi",
        "uid": 0,
        "add_time": 1500013066,
        "up_time": 1500013066,
        "__v": 0
      }
    ]
  }
}

描述: 添加项目分组

源码位置: ./server/controllers/interface.js:10

参数:

参数名 类型 描述 必选 支持版本
project_id Number 项目id,不能为空
path String 接口请求路径,不能为空
method String 请求方式
req_headers Array 请求的header信息
req_headers[].name String 请求的header信息名
req_headers[].value String 请求的header信息值
req_headers[].required Boolean 是否是必须,默认为否
req_headers[].desc String header描述
req_params_type String 请求参数方式,有["form", "json", "text", "xml"]四种
req_params Mixed 请求参数,如果请求方式是form,参数是Array数组,其他格式请求参数是字符串
req_params[].name String 请求参数名
req_params[].value String 请求参数值,可填写生成规则(mock)。如@email,随机生成一条email
req_params[].type String 请求参数类型,有["text", "file"]两种
res_body_type String 相应信息的数据格式,有["json", "text", "xml"]三种
res_body String 响应信息,可填写任意字符串,如果res_body_type是json,则会调用mock功能
desc String 接口描述
示例:

//请求  /interface/add
//header Content-Type:application/json

{
   "desc": "api",
   "method": "post",
   "path": "/testapi",
   "project_id": 8,
   "req_headers": [
      {
         "key": "h",
         "value": "t"
      }
   ],
   "req_params_type": "form",
   "req_params": [
      {
         "name": "uid",
         "value": 100,
         "type": "text"
      },
     {
         "name": "gid",
         "value": 1001,
         "type": "text"
      }
   ],
   "res_body_type": "json",
   "res_body": "{\"tt\": 222}"
}

//返回结果
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "__v": 0,
        "_id": 422,
        "project_id": 8,
        "path": "/testapi",
        "desc": "api",
        "method": "post",
        "req_params_type": "form",
        "res_body": "{\"tt\": 222}",
        "res_body_type": "json",
        "uid": 0,
        "add_time": 1499658569,
        "up_time": 1499658569,
        "req_params_form": [
            {
                "name": "uid",
                "value": "100",
                "_id": "5962f94940a7a5767088fcc0"
            },
            {
                "name": "gid",
                "value": "1001",
                "_id": "5962f94940a7a5767088fcbf"
            }
        ],
        "req_headers": [
            {
                "value": "t",
                "_id": "5962f94940a7a5767088fcc1"
            }
        ]
    }
}

描述: 添加项目分组

源码位置: ./server/controllers/interface.js:77

参数:

参数名 类型 描述 必选 支持版本
id Number 接口id,不能为空
示例:
./api/interface/get.json

描述: 添加项目分组

源码位置: ./server/controllers/interface.js:100

参数:

参数名 类型 描述 必选 支持版本
project_id Number 项目id,不能为空
示例:
./api/interface/list.json

描述: 添加项目分组

源码位置: ./server/controllers/interface.js:124

参数:

参数名 类型 描述 必选 支持版本
id Number 接口id,不能为空
path String 接口请求路径
method String 请求方式
req_headers Array 请求的header信息
req_headers[].name String 请求的header信息名
req_headers[].value String 请求的header信息值
req_headers[].required Boolean 是否是必须,默认为否
req_headers[].desc String header描述
req_params_type String 请求参数方式,有["form", "json", "text", "xml"]四种
req_params Mixed 请求参数,如果请求方式是form,参数是Array数组,其他格式请求参数是字符串
req_params[].name String 请求参数名
req_params[].value String 请求参数值,可填写生成规则(mock)。如@email,随机生成一条email
req_params[].type String 请求参数类型,有["text", "file"]两种
res_body_type String 相应信息的数据格式,有["json", "text", "xml"]三种
res_body String 响应信息,可填写任意字符串,如果res_body_type是json,则会调用mock功能
desc String 接口描述
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "n": 1,
        "nModified": 1,
        "ok": 1
    }
}

描述: 删除接口

源码位置: ./server/controllers/interface.js:189

参数:

参数名 类型 描述 必选 支持版本
id Number 接口id,不能为空
示例:
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "n": 1,
        "ok": 1
    }
}