主页 > API > 获取团队成员


获取团队成员

/v1/teams/:team_id/members
  • URL

    https://api.worktile.com/v1/teams/:team_id/members

  • HTTP请求方式

    GET

  • 支持格式

    JSON

    Header参数

    {
       "Content-Type":"application/json",
       "access_token":"xxx"
    }
    

    示例

    curl -l https://api.worktile.com/v1/teams/1111/members?access_token=xxx
    
  • HTTP请求参数

    参数 必选 类型 说明
    team_id true string 团队team_id
    access_token true string OAuth授权后获得,请求时可放在header中
  • 返回数据

    示例

    HTTP/1.1 200 ok

    [ { "uid":"d4745f9a9a6641c0a471182b6cdf909a", "name":"haifeng", "display_name":"徐大侠", "avatar":"5a69f6124d484f589996b1956126cf52.jpg", "online":0, "status":3, "email":"xudaxia@worktile.com", "desc":"我真的很靠谱", "role":1, "join_date":"2014-09-03T04:41:01.437Z" }, { "uid":"679efdf3960d45a0b8679693098135ff", "name":"gonglinjie", "display_name":"龚某某", "avatar":"default_avatar.png", "online":0, "status":3, "email":"gongmoumou@worktile.com", "desc":"", "role":2, "join_date":"2014-09-03T04:41:01.437Z" } ]


    返回值字段 类型 说明
    uid string 创建者uid
    name string 创建者用户名
    display_name string 创建者昵称
    email string 创建者邮箱
    desc string 创建者简介
    avatar string 创建者头像
    online number 成员在线状态,0:离线,1:在线,2:忙碌,3:离开
    status number 成员状态,1:正常,2:邀请,3:未确认(需要邮件验证)
    role number 成员角色,1:管理员,2:成员,3:游客
    join_date string 成员加入时间
  • 异常结果

    示例

    HTTP/1.1 401 Bad Request

    { "error_code":100005, "error_message":"没授权,请授权后再操作", "request":"/v1/teams/:team_id/members" }


    错误码(error_code) 错误信息(error_message) http状态码(statusCode)
    100005 没授权,请授权后再操作 401
    100006 access_token不正确 400
    300003 team_id不能为空 400
    300004 团队不存在 404
    300005 获取团队成员失败 500