资源工坊

获取应用在企业内的可见范围 ​

用于查询应用在企业内可以被使用的范围。其中，企业指的是授权 company_token 的企业。

请求说明 ​

请求地址配置域名+/o/woa/api/v1/developer/app/visible_range
请求方法GET
签名方式wps-4
支持应用类型企业自建应用、第三方企业应用
权限要求管理应用（kso.app.manage）

请求头 ​

名称是否必填说明
Content-Type是固定为: application/json
Wps-Docs-Date是取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT
Wps-Docs-Authorization是计算方法参考签名说明
Authorization是授权token，格式：Bearer ${access_token}，${access_token}需替换为从授权接口获取的access_token值

请求示例 ​

http
[GET] 配置域名+/o/woa/api/v1/developer/app/visible_range

响应体 ​

名称类型说明
resultinteger状态码，非 0 表示失败，参照《状态码说明》
usersarray可见范围内的用户信息
 ∟ idinteger用户 id
 ∟ namestring用户名称
departmentsarray可见范围内的部门信息
 ∟ idstring部门 id
 ∟ namestring部门名称
companyobject可见范围内的企业信息，仅当可见范围为全企业时返回此字段
 ∟ idinteger企业 id
 ∟ namestring企业名称

响应体示例 ​

json
{
  "users": [
    {
      "id": 12345, // 人员id
      "name": "xxx" // 人员名称
    }
  ],
  "departments": [
    {
      "id": "12345", // 部门id
      "name": "xxx" // 部门名称
    }
  ],
  "company": {
    "id": 12345, // 企业id
    "name": "xxx" // 企业名称
  },
  "result": 0
}