获取指定角色信息

获取指定角色信息

请求说明

请求地址	配置域名+/o/woa/api/v1/announce/developer/role
请求方法	GET
签名方式	wps-4
支持应用类型	企业自建应用、第三方企业应用
权限要求	批量导入公告权限角色(kso.announce_role.readwrite)

请求头

Header名称	是否必填	说明
Content-Type	是	目前固定为："application/json"
Wps-Docs-Date	是	取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT
Wps-Docs-Authorization	是	计算方法参考签名说明
Authorization	是	access_token(企业授权获取的token)

请求地址示例

[GET] 配置域名+/o/woa/api/v1/announce/developer/role?operator=123?role_id=123?role_name=aaa

查询参数（Query）

名称	类型	是否必填	说明
operator	int	是	操作人（wpsUid）
role_id	int	否	角色id，当此值不为空时使用该值查询角色信息
role_name	int	否	角色名，当此值不为空且role_id为空时使用该值查询角色信息

请求体（body）

无

响应体

名称	类型	说明
result	string	ok：成功，其他-失败
data	object	响应数据
∟ role_id	int	角色id
∟ role_name	string	角色名称
∟ role_tabs	[]string	权限范围列表
∟ users	[]object	角色下用户id列表
∟ corp_id	string	用户公司id
∟ user_id	string	用户id
∟ send_range	[]object	公告发送范围
∟ corp_id	string	发送范围全公司时，公司id
∟ departments	[]object	发送范围为部门时，部门信息
∟ corp_id	string	公司id
∟ dept_id	string	部门id
∟ users	[]object	可发送的用户
∟ corp_id	string	用户公司id
∟ user_id	string	用户id

响应体示例

{
  "data": {
    "role_id": 7,
    "role_name": "测试角色666",
    "role_tabs": ["announcement_management"],
    "users": [
      {
        "user_id": "96",
        "corp_id": "0"
      }
    ],
    "send_range": {
      "corp_id": "0",
      "departments": [
        {
          "dept_id": "16",
          "corp_id": "3"
        }
      ],
      "users": [
        {
          "user_id": "97",
          "corp_id": "3"
        },
        {
          "user_id": "98",
          "corp_id": "3"
        },
        {
          "user_id": "99",
          "corp_id": "3"
        }
      ]
    }
  },
  "result": "ok"
}