查询所有团队的标注成员列表

功能介绍

查询所有团队的标注成员列表。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v2/{project_id}/workforces/workers

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	用户项目ID。获取方法请参见获取项目ID和名称。

表2 Query参数
参数	是否必选	参数类型	描述
limit	否	Integer	指定每一页返回的最大条目数，取值范围[1,100]，默认为10。
offset	否	Integer	分页列表的起始页，默认为0。
order	否	String	指定查询的排序顺序。可选值如下： asc：递增排序 desc：递减排序（默认值）
role	否	Integer	根据成员角色过滤查询。可选值如下： 0：标注人员（默认值） 1：审核人员 2：团队管理员
sort_by	否	String	指定查询的排序方式。可选值如下： create_time：按创建时间排序（默认值） email：按邮件排序

请求参数

无

响应参数

状态码： 200

表3 响应Body参数
参数	参数类型	描述
total_number	Integer	标注团队成员总数。
workers	Array of Worker objects	分页查询到的标注团队成员列表。

表4 Worker
参数	参数类型	描述
create_time	Long	创建时间。
description	String	标注成员描述，长度为0-256位，不能包含^!<>=&"'特殊字符。
email	String	标注成员邮箱。
role	Integer	角色。可选值如下： 0：打标者 1：审核者 2：团队管理者 3：数据集拥有者
status	Integer	标注成员的当前登录状态。可选值如下： 0：未发送邀请邮件 1：已发送邀请邮件但未登录 2：已登录 3：标注成员已删除
update_time	Long	更新时间。
worker_id	String	标注成员ID。
workforce_id	String	所属标注团队ID。

请求示例

查询所有团队的标注管理员

GET https://{endpoint}/v2/{project_id}/workforces/workers??role=2

响应示例

状态码： 200

{
  "total_number" : 2,
  "workers" : [ {
    "email" : "xxx@xxx.com",
    "worker_id" : "df40e4afcb793d13f01f6c9022341e6f",
    "workforce_id" : "feSUo5NUIUnQAQNNTiS",
    "status" : 0,
    "role" : 2,
    "description" : "",
    "create_time" : 1595927749772,
    "update_time" : 1595927749772
  }, {
    "email" : "xxx@xxx.com",
    "worker_id" : "27906df1d06c0827b7c24f761d618541",
    "workforce_id" : "XiL5RcHmxyIt3aYIOtI",
    "status" : 0,
    "role" : 2,
    "description" : "",
    "create_time" : 1590027298717,
    "update_time" : 1590027298717
  } ]
}