用户管理系统接口文档

转自:http://redhacker.iteye.com/blog/1118676

用户管理系统接口文档

目录

一、角色定义
1.    URI:/sys/{sysCode}/role/
(1)post
(2)get
2.    URI:/sys/{sysCode}/role/deletebatch/
(1)post
3.    URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/
(1)put
(2)delete
4.URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/menu/
(1)post
(2)get
5.    URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/menu/{menuId:[\\w]{32}}/
(1)delete
6.    URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/menu/deletebatch/
(1)post
7.    URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/menu/exclude/
(1)get:
二、角色授权
1.    URI:/sys/{sysCode}/role/
(1)get
2.    URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/post/
(2)post
3.    URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/post/{postId:[\\w]{32}}/
(1)delete
4.    URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/post/deletebatch/
(1)post
5.    URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/user/
(2)post
6.    URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/user/{userId:[\\w]{32}}/
(1)delete
7.    URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/user/deletebatch/
(1)post
8.    URI:/post-user/
(1)get
9.    URI:/post/
(1)get
10.    URI:/user/
(1)get
三、资源授权
1.    URI:/sys/
(1)get
2.    URI:/sys/{sysCode}/resource/
(1)get
(2)post
3.    URI:/sys/{sysCode}/resource/{resourceId:[\\w]{32}}/
(1)put
(2)delete
4.    URI:/sys/{sysCode}/resource/deletebatch/
(1)post
四、系统授权
1.    URI:/sys/
(1)get
(2)post
2.    URI:/sys/{sysCode}/menu/
(1)post
(2)get
3.    URI:/sys/{sysCode}/menu/deletebatch/
(1)post
4.    URI:/sys/{sysCode}/menu/{menuId:[\\w]{32}}/
(1)get
(2)put
5.    URI:/sys/{sysCode}/resource/
(1)get

 

修改记录

修订者

日期

备注

窦国强

2008.10.17

初建文档

   

一、角色定义

1. URI:/sys/{sysCode}/role/
(1)post

描述:增加一个角色到某系统(如质量系统)

Request message header

Accept: application/json

Content-Type: application/json

Request message body

{

name:张三, //角色名称

desc:取样人员 //角色描述

}

Response status201

Response message header

Content-type: application/json

Content-Location:http://www.jlerp.com/sys/001/role/001

Response message body

{

uid:001,

name: 张三,

initCaptial: 'zhangsan',

desc:取样人员 //角色描述

}

(2)get

描述:获取所有角色

Request message header

Accept: application/json

Cache-Control: max-age=300

Response status200

Response message header

Content-type: application/json

Cache-Control: max-age=300

Response message body

{

roles:

[

{name:zhangsan,uid:001,initCaptial: 'zhangsan',desc:’’},

{name:zhangsan2,uid:002,initCaptial: 'zhangsan2',desc:’’},

{name:zhangsan3,uid:003,initCaptial: 'zhangsan3',desc:’’}

]

}

2. URI:/sys/{sysCode}/role/deletebatch/
(1)post

描述:从系统批量删除角色

Request message header

Accept: application/json

Content-Type: application/json

Request message body

{

Roles:[

{roleid:001},

{roleid:002}

]

}

Response status204

Response message header

Content-type: application/json

3. URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/
(1)put

描述:修改角色/保存角色描述

Request message header

Accept: application/json

Content-Type: application/json

Request message body

{

name:取样人员,

desc:吴三桂

}

Response status200

Response message header

Content-type: application/json

Response message body

{

role:{

name:'zhangsan',

uid:001,

initCaptial:'zhangsan1',

desc:’’

}

}

(2)delete

描述:从系统删除某个角色

Request message header

Accept: application/json

Content-Type: application/json

Response status204

Response message header

Content-type: application/json

4. URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/menu/
(1)post

描述:新增某角色下面的菜单树节点

Request message header

Accept: application/json

Content-Type: application/json

Request message body

{

menus:[{uid:1},{uid:2}]

}

Response status201

Response message header

Content-type: application/json

Content-Location:http://www.jlerp.com/sys/sys001/role/001/menu

Cache-Control:no-cache

Pragma: no-cache

Response message body

{

menutree:

[

{

id: 1,

text: '原料样品',

singleClickExpand: true,

expanded: true,

children: [{

id: 1.1,

text: '原料化验',

leaf: true

},

{

id: 1.2,

text: '原料审核',

leaf: true

},

{

id: 1.3,

text: '原料判定',

leaf: true

}

]

},{

id: 2,

text: '生产样品',

children: []

}

]

}

(2)get

描述: 获取某角色下面的菜单树

Request message header

Accept: application/json

Cache-Control: max-age=300

Response status200

Response message header

Content-type: application/json

Cache-Control: max-age=300

Response message body

{

menutree:

[

{

id: 1,

text: '原料样品',

singleClickExpand: true,

expanded: true,

children: [{

id: 1.1,

text: '原料化验',

leaf: true

},

{

id: 1.2,

text: '原料审核',

leaf: true

},

{

id: 1.3,

text: '原料判定',

leaf: true

}

]

},{

id: 2,

text: '生产样品',

children: []

}

]

}

5. URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/menu/{menuId:[\\w]{32}}/
(1)delete

描述:删除某个角色下面的某个菜单节点

Request message header

Accept: application/json

Content-Type: application/json

Response status204

Response message header

Content-type: application/json

6. URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/menu/deletebatch/
(1)post

描述:批量删除某个角色下面的菜单节点

Request message header

Accept: application/json

Content-Type: application/json

Request message body

{

menus: [{uid:1},{uid:2}]

}

Response status204

Response message header

Content-type: application/json

7. URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/menu/exclude/
(1)get:

描述: 获取所选角色未拥有的菜单

Request message header

Accept: application/json

Cache-Control: max-age=300

Response status200

Response message header

Content-type: application/json

Cache-Control: max-age=300

Response message body

{

menutree:

[

{

id: 1,

text: '原料样品',

singleClickExpand: true,

expanded: true,

children: [{

id: 1.1,

text: '原料化验',

leaf: true

},

{

id: 1.2,

text: '原料审核',

leaf: true

},

{

id: 1.3,

text: '原料判定',

leaf: true

}

]

},{

id: 2,

text: '生产样品',

children: []

}

]

}

二、角色授权

1. URI:/sys/{sysCode}/role/
(1)get

描述:获取所有角色

Request message header

Accept: application/json

Cache-Control: max-age=300

Response status200

Response message header

Content-type: application/json

Cache-Control: max-age=300

Response message body

{

roles:

[

{name:zhangsan,uid:001,initCaptial: 'zhangsan',desc:’’},

{name:zhangsan2,uid:002,initCaptial: 'zhangsan2',desc:’’},

{name:zhangsan3,uid:003,initCaptial: 'zhangsan3',desc:’’}

]

}

2. URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/post/
(2)post

描述:增加一个岗位到某个角色下

Request message header

Accept: application/json

Content-Type: application/json

Request message body

{postId:001}

Response status201

Response message header

Content-type: application/json

Content-Location:http://www.jlerp.com/sys/001/role/001/post/100

Cache-Control:no-cache

Pragma: no-cache

Response message body

{

name:”软件工程师”:,

uid:001,

initCaptial:”000298”

org: “信息化部”

}

3. URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/post/{postId:[\\w]{32}}/
(1)delete

描述:从某个角色删除某个岗位

Request message header

Accept: application/json

Content-Type: application/json

Cache-Control: max-age=0

Response status204

Response message header

Content-type: application/json

Cache-Control:no-cache

Pragma: no-cache

4. URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/post/deletebatch/
(1)post

描述:从某个角色批量删除岗位

Request message header

Accept: application/json

Content-Type: application/json

Request message body

{

posts:[

{postId:001},

{postId:002}

]

}

Response status204

Response message header

Content-type: application/json

5. URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/user/
(2)post

描述:增加一个人员到某个角色

Request message header

Accept: application/json

Content-Type: application/json

Request message body

{ uid:001}

Response status201

Response message header

Content-type: application/json

Content-Location:http://www.jlerp.com/sys/001/role/001/user/100

Response message body

{

person: code + ”(“ + name + ”)”,

name:”软件工程师”,

uid:001,

initCaptial:”000298”,

initName:”wxw”

}

6. URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/user/{userId:[\\w]{32}}/
(1)delete

描述:从某个角色删除某个人员

Request message header

Accept: application/json

Content-Type: application/json

Response status204

Response message header

Content-type: application/json

7. URI:/sys/{sysCode}/role/{roleId:[\\w]{32}}/user/deletebatch/
(1)post

描述:从某个角色批量删除人员

Request message header

Accept: application/json

Content-Type: application/json

Request message body

{

users:

[

{Uid:001},

{Uid:002}

]

}

Response status204

Response message header

Content-type: application/json

8. URI:/post-user/
(1)get

描述: 获取某角色下的所有岗位及所有人员

Request message header

Accept: application/json

Cache-Control: max-age=300

Response status200

Response message header

Content-type: application/json

Cache-Control: max-age=300

Response message body

{

users:

[

{

person: code + ”(“ + name + ”)”,

uid:001,

initCaptial:”000298”,

initName:”wxw”

},

{

person: code + ”(“ + name + ”)”,

uid:001,

initCaptial:”000293”,

initName:”wxz”

}

],

posts

[

{name:软件工程师1,uid:001,initCaptial: 'rjgcs',org: '信息化部'},

{name:软件工程师2,uid:001,initCaptial: 'rjgcs',org: '信息化部'},

{name:软件工程师3,uid:001,initCaptial: 'rjgcs',org: '信息化部'}

]

}

9. URI:/post/
(1)get

描述: 获取所有岗位

Request message header

Accept: application/json

Cache-Control: max-age=300

Response status200

Response message header

Content-type: application/json

Cache-Control: max-age=300

Response message body

{

posts:

[

{

uid:001,

name:”软件工程师”,

initCaptial:”rjgcs”,

org:”信息化部”

},

{

uid:002,

name:”网络工程师”,

initCaptial:”wlgcs”,

org:”信息化部”

}

]

}

10. URI:/user/
(1)get

描述: 获取所有人员

Request message header

Accept: application/json

Cache-Control: max-age=300

Response status200

Response message header

Content-type: application/json

Cache-Control: max-age=300

Response message body

{

users:

[

{

person: code + ”(“ + name + ”)”,

uid:001,

initCaptial:”000298”,

initName:”wxw”

},

{

person: code + ”(“ + name + ”)”,

uid:001,

initCaptial:”000293”,

initName:”wxz”

}

]

三、资源授权

1. URI:/sys/
(1)get

描述:获取系统信息

Request message header

Accept: application/json

Response status200

Response message header

Content-type: application/json

Response message body

[

{

name: "质量系统",

uid:001,

code: "qa",
initCaptial: "zlxt"

},

{

name: "财务系统",

uid:001,

code: "qb",

initCaptial: "cwxt"

}

]

2. URI:/sys/{sysCode}/resource/
(1)get

描述:获取指定系统下的全部资源

Request message header

Accept: application/json

Response status200

Response message header

Content-type: application/json

Response message body

{

resource:

[

{

uid:0101,

resource:www.abc.com,

description:资源描述,

methods:post,get,put,delete

},

{

uid:0102,

resource:www.abc2.com,

description:资源描述2,

methods:"post,delete"

}

]

}

(2)post

描述:新增资源

Request message header

Accept: application/json

Content-Type: application/json

Request message body

{

resource:www.abc.com,

description:资源描述,

methods:"get,pots,put,delete"

}

Response status201

Response message header

Content-type: application/json

Content-Location:http://www.jlerp.com/sys/001/resource/001

Response message body

{

uid:0102,

resource:www.abc.com,

description:资源描述,

methods:"get,pots,put,delete"

}

3. URI:/sys/{sysCode}/resource/{resourceId:[\\w]{32}}/
(1)put

描述:修改资源

Request message header

Accept: application/json

Content-Type: application/json

Request message body

{

resource:www.abc2.com,

description:资源描述2,

methods:"get,pots,put"

}

Response status200

Response message header

Content-type: application/json

Response message body

{

uid:0102,

resource:www.abc2.com,

description:资源描述2,

methods:"get,post,put"

}

(2)delete

描述:删除单个资源

Response status200

4. URI:/sys/{sysCode}/resource/deletebatch/
(1)post

描述:批量删除资源

Request message header

Content-Type: application/json

Request message body

{resource:[{uid:1},{uid:2}]}

Response status:204

四、系统授权

1. URI:/sys/
(1)get

描述:获取所有系统

参看:3.1.1

(2)post

描述:维护系统(新增,修改,删除)

Request message header

Accept: application/json

Request message body

{

system:[

{

Uid:”xx”,

Name:”xx”,

Code:””

},

{

Uid:”xx”,

Name:”xx”,

Code:””

}

]

}

Response status200

Response message header

Content-type: application/json

Response message body

[

{

name: "质量系统",

uid: "1",

code: "qa",

description: “质量系统”,
initCaptial: "zlxt"

},

{

name: "财务系统",

uid: "2",

code: "qb",

description:”财务系统”,

initCaptial: "cwxt"

}

]

2. URI:/sys/{sysCode}/menu/
(1)post

描述:给系统增加一个菜单节点(功能)

Request message header

Accept: application/json

Request message body

{

menuItem:{

name:xxx,

isdirectory:0,

puid:003

}

menuResource:[

{

menuid:001,

resourceId:002,

method:”post,get,put,delete”,

ismain:0

},

{

menuid:001,

resourceId:002,

method:”post,get,put,delete”,

ismain:1

}

]

}

Response status200

Response message header

Content-type: application/json

Response message body

{

uid:001,

name:”xxx”,

url:”yyy”

}

(2)get

描述:获取指定系统下的所有功能

Request message header

Accept: application/json

Response status200

Response message header

Content-type: application/json

Response message body

[{

id:’1’,

name:’质量系统’,

initCaptial:’zlxt’,

uiProvider:’col’,

singleClickExpand:true,

children:[

{

id:’2’,

name:’原料样品’,

initCaptial:’ylyp’,

uiProvider:’col’,

singleClickExpand:true,

children:[

{

id:’3’,

name:’原料化验’,

initCaptial:’ylhy’,

url:’http://qa.ejianlong.com’,

leaf:true,

uiProvider:’col’

},

{

id:’4’,

name:’原料审核’,

initCaptial:’ylsh’,

url:’http://qa.ejianlong.com’,

leaf:true,

uiProvider:’col’

},

{

id:’5’,

name:’原料判定’,

initCaptial:’ylpd’,

url:’http://qa.ejianlong.com’,

leaf:true,

uiProvider:’col’

}

]

},
{

id:’6’,

name:’生产样品’,

initCaptial:’scyp’,

singleClickExpand:true,

uiProvider:’col’,

children:[]

},
{

id:’7’,

name:’抽检样品’,

initCaptial:’cjyp’,

singleClickExpand:true,

uiProvider:’col’,

children:[]

},
{

id:’8’,

name:’ 角色授权’,

initCaptial:’jssq’,

singleClickExpand:true,

uiProvider:’col’,

children:[]

},
{

id:’9’,

name:’系统授权’,

initCaptial:’xtsq’,

singleClickExpand:true,

uiProvider:’col’,

children:[]

},
{

id:’10’,

name:’资源授权’,

initCaptial:’zysq’,

singleClickExpand:true,

uiProvider:’col’,

children:[]

}

]

}]

3. URI:/sys/{sysCode}/menu/deletebatch/
(1)post

描述:从系统中批量删除菜单节点

Request message header

Accept: application/json

Request message body

{

menuitem:[

{

uid:001

},

{

uid:002

}

]

}

Response status200

4. URI:/sys/{sysCode}/menu/{menuId:[\\w]{32}}/
(1)get

描述:获取系统下某菜单节点的相关信息

Request message header

Accept: application/json

Response status200

Response message header

Content-type: application/json

Response message body

{

name: ”xxx”,

url: ”xxx”,

resources:[

{

url: ”xxx”,

post: true,

get: true,

put: true,

delete: true

},

{

url: ”yyy”,

post: true,

get: true,

put: true,

delete: true

}

]

}

(2)put

描述:修改系统下的菜单节点

Request message header

Accept: application/json

Request message body

{

menuItem:{

name:xxx

},

menuResource:[

{

menuid:001,

resourceId:002,

method:”post,get,put,delete”,

ismain:0

},

{

menuid:001,

resourceId:002,

method:”post,get,put,delete”,

ismain:1

}

]

}

Response status200

Response message header

Content-type: application/json

Response message body

{

uid:001,

name:”xxx”,

url:”yyy”

}

5. URI:/sys/{sysCode}/resource/
(1)get

描述:获取所有资源

参看:3.2.1

转载于:https://www.cnblogs.com/afarmer/archive/2011/12/05/2277060.html

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值