资源工坊

获取关联组织的指定部门的用户列表 ​

获取用户在当前关联组织的指定部门下的用户列表

请求说明 ​

请求地址https://openapi.wps.cn/v7/partners/{partner_id}/depts/{dept_id}/members
请求方法GET
签名方式KSO-1
权限要求查询和管理通讯录信息（应用授权） kso.contact.readwrite
查询通讯录信息（应用授权） kso.contact.read

请求头（Header） ​

Header 名称参数类型是否必填说明
Content-Typestring是使用：application/json
X-Kso-Datestring是RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-Authorizationstring是KSO-1 签名值，详见《签名方法》
Authorizationstring是授权凭证，格式为：Bearer {access_token}

路径参数（Path） ​

名称参数类型说明
partner_idstring关联组织 id
dept_idstring关联组织的部门id。dept_id传0时：若企业共享了根部门，即获取到根部门下用户列表；若企业未共享根部门，则获取到共享范围内的非共享部门下的用户列表

查询参数（Query） ​

名称参数类型是否必填说明
page_sizeinteger否分页大小，默认为：10，最大值：50
page_tokenstring否分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果

请求地址示例 ​

[GET] https://openapi.wps.cn/v7/partners/{partner_id}/depts/{dept_id}/members

响应体 ​

名称参数类型说明
codeinteger响应代码。非 0 表示失败，参照《状态码说明》
msgstring响应信息
dataobject响应数据
∟ next_page_tokenstring下一页token
∟ usersarray[object]关联组织用户列表信息
∟ ∟ user_idstring用户id
∟ ∟ company_idstring公司id
∟ ∟ user_namestring用户名称
∟ ∟ user_avatarstring用户头像

响应体示例 ​

json
{
  "data": {
    "users": [
      {
        "company_id": "string",
        "user_id": "string",
        "user_name": "string",
        "user_avatar": "string"
      }
    ],
    "next_page_token": "string"
  },
  "msg": "string",
  "code": 0
}