1. 角色API列表

1.1. 添加角色标签

URL: /gateway/openimport/open/roletag/addRoleTag?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
    "eid": "2704254",
    "roleName": "接口测试角色2"
}

输出: 参见输出结果,其中data字段格式如下：

[
    {
        "id": "a20b2811-fda4-11e6-8f64-82e47cc7294a" //角色id,请保存
    }
]

1.2. 获取工作圈角色标签列表

URL: /gateway/openimport/open/roletag/getCompanyRoleTag?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
    "eid": "2704254"
}

输出: 参见输出结果,其中data字段格式如下：

[
    [
        {
            "id": "a96a4199-1661-11e6-8fae-82e47cc7294a", //角色id
            "createtime": "May 10, 2016 11:45:39 AM",
            "rolename": "HR管理员",
            "lastupdatetime": "May 10, 2016 11:45:39 AM",
            "createpersonid": "", //创建人id
            "appid": "", //如果是第三方应用创建，appid就会有值
            "iscommon": 0, //是否系统常用标签
            "type": 10, //标签类型，10系统标签，20 自建应用标签，30 第三方应用标签 40 企业自定义标签
            "eid": "" //如果是企业自定义标签，就会有值
        }
    ]
]

1.3. 删除角色标签

URL: /gateway/openimport/open/roletag/deleteRoleTag?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
    "eid": "2704254",
    "roleId": "a20b2811-fda4-11e6-8f64-82e47cc7294a"
}

输出: 参见输出结果,其中data字段格式如下： 正常data返回空。

1.4. 更改角色标签名字

URL: /gateway/openimport/open/roletag/updateRoleTag?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
    "eid": "2704254",
    "roleId": "acca7a9d-f4bd-11e6-8f64-82e47cc7294a",
    "roleName": "测试角色3"
}

输出: 参见输出结果,其中data字段格式如下： 正常data返回空。

1.5. 设置人员角色标签

URL: /gateway/openimport/open/roletag/setPersonRoleTag?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
    "eid": "2704254",
    "roleId": "2d69412f-8de5-11e6-961a-82e47cc7294a",
    "openId": "580d9fa000b0911f84defd18",
    "orgIds": "02008582-08dc-40a0-8d5b-c693f73d2798,03c70e4b-5e10-11e6-961a-82e47cc7294a" //设置作用范围
}

输出: 参见输出结果,其中data字段格式如下： 正常data返回空。

1.6. 删除人员角色标签

URL: /gateway/openimport/open/roletag/deletePersonRoleTag?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
    "eid": "2704254",
    "roleId": "2d69412f-8de5-11e6-961a-82e47cc7294a",
    "openId": "580d9fa000b0911f84defd18"
}

输出: 参见输出结果,其中data字段格式如下： 正常data返回空。

1.7. 根据角色获取人员（不建议使用此接口，建议使用本页1.10接口）

URL: /gateway/openimport/open/roletag/getPersonByRole?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
    "eid": "2704254",
    "roleId": "2d69412f-8de5-11e6-961a-82e47cc7294a"
}

输出: 参见输出结果,其中data字段格式如下：

[
    {
        "orgIds": "938fe848-c73c-4331-b883-144c8b9d3a06", //作用范围
        "openId": "580d9fa000b0911f84defd18"
    }
]

1.8. 根据用户id批量设置人员角色

URL:/gateway/openimport/open/roletag/batchSetPersonRoleTag?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
    "eid": "332165",
    "operate": "insert",//operate标志是添加角色/删除 insert/delete
    "roleTags": [
        {
            "openId": "580d9fa000b0911f84defd18",
            "roleOrgs": [
                {
                    "roleId": "2d69412f-8de5-11e6-961a-82e47cc7294a",
                    "orgids": [
                        "938fe848-c73c-4331-b883-144c8b9d3a06", //作用范围1
                        "03c70e4b-5e10-11e6-961a-82e47cc7294a" //作用范围2
                    ]
                },... // 批量操作，针对这个用户（openId），分配不同的角色（roleId）以及开通范围。不同的角色传成数组
            ]
        },... // 批量操作，不同的用户（openid）传成数组
    ]
}

输出: 参见输出结果,其中data字段格式如下： 正常data返回空。

1.9. 根据角色id批量设置人员角色

URL:/gateway/openimport/open/roletag/batchSetPersonRoleTag_other?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
    "eid": "332165",
    "operate": "insert",
    "roleTags": [
        {
            "roleId": "2d69412f-8de5-11e6-961a-82e47cc7294a",
            "personOrgs": [
                {
                    "openId": "580d9fa000b0911f84defd18",
                    "orgids": [
                        "938fe848-c73c-4331-b883-144c8b9d3a06", //作用范围1
                        "03c70e4b-5e10-11e6-961a-82e47cc7294a" //作用范围2
                    ]
                },... //批量操作，针对这个角色（roleId），分配不同的用户（openId），不同的用户传成数组
            ]
        },... //批量操作，不同的角色（roleId）传成数组
    ]
}

输出: 参见输出结果, 正常data返回空。

1.10. 根据角色Id分页获取人员

URL:/gateway/openimport/open/roletag/getPersonsByRoleAndPage?accessToken=xxxxxx

输入: 参见输入参数，其中data字段格式如下:

{
    "eid": "2704254",
    "roleId": "2d69412f-8de5-11e6-961a-82e47cc7294a",
    "begin"：0,
    "count"：100
}

输出:参见输出结果,其中data字段格式如下：

[
    {
        "orgIds": "938fe848-c73c-4331-b883-144c8b9d3a06", //作用范围
        "openId": "580d9fa000b0911f84defd18"
    }
]

1.11. FAQ

暂无