主页 > API > 项目添加成员


项目添加成员

/v1/projects/:pid/members
  • URL

    https://api.worktile.com/v1/projects/:pid/members

  • HTTP请求方式

    POST

  • 支持格式

    JSON

    Header参数

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

    示例

    curl -d 'uid=333&role=3&access_token=xxx' 'https://api.worktile.com/v1/projects/22222/members'
    
  • HTTP请求参数

    参数 必选 类型 说明
    pid true string 项目uid
    uid true string 成员uid
    role true number 成员角色
    access_token true string OAuth2授权后获得,请求时可放在header中
  • 返回数据

    示例

    HTTP/1.1 200 ok

    { "uid":"85b0868f5d3c4360a6c14427c4ea6fd2", "name":"liulei321", "display_name":"liulei", "avatar":"default_avatar.png", "desc":"", "status":1, "online":0, "role":3 }


    返回值字段 类型 说明
    uid string 成员uid
    name string 成员用户名
    display_name string 成员昵称
    avatar string 成员头像
    desc string 成员描述
    status number 成员状态,1:正常,2:邀请,3:需要邮件确认
    online number 在线状态,0:离线,1:在线,2:忙碌,3:离开
    role number 角色,1:管理员,2:成员,游客
  • 异常结果

    示例

    HTTP/1.1 401 Unauthorized

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


    错误码(error_code) 错误信息(error_message) http状态码(statusCode)
    100005 没授权,请授权后再操作 401
    100006 access_token不正确 400
    400006 设定的成员角色不正确 400
    400007 该成员已经存在 400
    400008 添加成员失败 500
    400009 该成员不在团队中