获取项目成员

GET

/v1.0/project/users/{userId}/projects/{projectId}/members

调用本接口获取项目成员。

接口功能介绍

调用本接口，根据操作者ID和项目ID，查询项目中的成员。示例如下：

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	项目应用项目读权限	API Explorer
第三方企业应用	支持	项目应用项目读权限	API Explorer
第三方个人应用	暂不支持	项目应用项目读权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	user.not.exist	user not exist	用户在当前企业中不存在。
400	org.not.exist	org not exist	当前企业在Teambition中不存在。
500	server.error	system error	系统内部服务错误。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.dingtalk.com/v1.0/project/users//projects//members?userIds=String&projectRoleId=String&maxResults=Integer&skip=Integer' \
--header 'x-acs-dingtalk-access-token;'

响应示例

{
    "result": [
        {
            "memberId": "string",
            "userId": "string",
            "role": 0,
            "roleIds": [
                "string"
            ]
        }
    ]
}

请求参数

Path 参数

userId

string

必需

操作者userId。

projectId

string

必需

项目ID：

企业内部应用，可通过调用查询项目接口，获取返回参数projectId字段。
第三方企业应用，可通过调用查询项目接口，获取返回参数projectId字段。

Query 参数

userIds

string

可选

用户ID。

说明
多个ID，使用英文逗号分隔。

示例值:

String

projectRoleId

string

可选

项目角色ID。

说明
仅查询拥有该角色的成员，并且仅支持单个角色查询。

示例值:

String

maxResults

string

可选

每页返回最大数量。默认10，最大300。

示例值:

Integer

skip

string

可选

跳过的数据数量。

示例值:

Integer

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。

企业内部应用，调用获取企业内部应用的accessToken接口获取。

第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

返回响应

🟢200成功

application/json

Body

result

array [object {4}]

项目成员列表。

必需

memberId

string

项目成员ID。

可选

userId

string

用户ID。

可选

role

integer

可选

项目角色： 0：成员 1：管理员 2：拥有者

roleIds

array[string]

项目角色ID。

可选

修改于 2024-01-15 03:06:46

恢复项目归档

查询项目状态

获取项目成员

接口功能介绍#

权限#

错误码#

请求参数

返回响应

接口功能介绍

权限

错误码