这是我们崭新的REST API的文档页面-并不是要找到它。此API尚未准备好供公众使用。随着我们的成长,我们正在砍伐和改变很多。因此,如果您构建使用它的东西,那么很可能在以后的更新中中断。 不要说您没有被警告!
网址: | //api.meituohu.com/v2/roles |
方法): | 获取,发布,放置,删除 |
回应格式: | JSON,XML |
描述: | 此方法使您可以检索,创建,更新和删除角色。各个资源由角色编号标识。因此/ roles / 123将返回编号为123的角色。类似地,对该URL的PUT将更新角色123。 |
参量
名称 | 类型 | 描述 |
---|---|---|
数 | 数字 | 分配给角色的公司特定编号 |
名称 | 串 | 角色名称 |
权限 | 采集 | 属于角色的权限列表 |
描述 | 串 | 角色说明 |
用户名 | 采集 | 属于角色的用户名列表 |
用户数 | 数字 | 属于该角色的用户名数量 |
IsAdmin | 布尔型 | 指示用户是否为管理员的标志。 True表示用户是admin。 |
GET操作
获取角色列表–网址: /角色
角色列表获取的示例响应
[{
"描述": "role with full access on all features",
"IsAdmin": false,
"用户数": 0,
"权限": [],
"数": 12,
"名称": "Full Access",
"用户名": []
}, {
"描述": "role with full access on projects",
"IsAdmin": false,
"用户数": 0,
"权限": ["ViewProject","CreateProject","UpdateProject","DeleteProject"],
"数": 13,
"名称": "专案 only (full access)",
"用户名": []
}, {
"描述": "role with full access on quotes",
"IsAdmin": false,
"用户数": 0,
"权限": ["ViewQuote","CreateQuote","UpdateQuote","DeleteQuote"],
"数": 14,
"名称": "行情 only (full access)",
"用户名": []
}, {
"描述": "role with readonly access on projects and quotes",
"IsAdmin": false,
"用户数": 0,
"权限": ["ViewQuote","ViewProject"],
"数": 15,
"名称": "专案 & 行情 (read only)",
"用户名": []
}, {
"描述": "role with read and create permissions on quotes an",
"IsAdmin": false,
"用户数": 0,
"权限": [],
"数": 16,
"名称": "专案 & 行情 (read/create only) ",
"用户名": []
}]
获取特定角色的详细信息–
网址: / roles / {number}
GET角色示例响应
{
"描述": "role with readonly access on projects and quotes",
"IsAdmin": false,
"用户数": 0,
"权限": ["ViewQuote","ViewProject"],
"数": 15,
"名称": "专案 & 行情 (read only)",
"用户名": []
}
开机自检操作
使用给定的角色数据创建角色–网址: /角色
角色POST的示例请求
{
"描述": "role with readonly access on projects and quotes",
"权限": ["ViewQuote","ViewProject"],
"名称": "专案 & 行情 (read only)"
}
PUT操作
更新指定角色的角色详细信息–网址: / roles / {number}
URL中的{number}应该替换为要更新的角色的编号。
角色请求的示例请求
{
"描述": "role with readonly access on projects and quotes",
"权限": ["ViewQuote","ViewProject"],
"数": 15,
"名称": "专案 & 行情 (read only)"
}
删除操作
删除具有URL中提供的编号的角色–网址: / roles / {number}