企业微信服务端API理解——通讯录管理篇（后续还有部分需要补足）

开始开发：

使用通讯录管理接口：

原则上需要使用 通讯录管理secret，也可以使用 应用secret。
但是使用应用secret只能进行“查询”、“邀请”等非写操作，而且只能操作应用可见范围内的通讯录。

获取通讯录管理secret的方法如下：

1、进入企业微信管理后台，在“管理工具” — “通讯录同步助手”开启“API接口同步”
2、开启后，可设置通讯录API的权限：读取或者编辑通讯录

创建成员：

请求方式：POST（HTTPS）
请求地址：
https://qyapi.weixin.qq.com/cgi-bin/user/create?access_token=ACCESS_TOKEN（这里是需要更改的）

请求包体（具体参数名称，请看官网api的参数说明）：示例

{
    "userid": "zhangsan",
    "name": "张三",
    "alias": "jackzhang",
    "mobile": "13800000000",
    "department": [1, 2],
    "order":[10,40],
    "position": "产品经理",
    "gender": "1",
    "email": "[email protected]",
    "is_leader_in_dept": [1, 0],
    "enable":1,
    "avatar_mediaid": "2-G6nrLmr5EC3MNb_-zL1dDdzkd0p7cNliYu9V5w7o8K0",
    "telephone": "020-123456",
    "address": "广州市海珠区新港中路",
    "main_department": 1,
    "extattr": {
        "attrs": [
            {
                "type": 0,
                "name": "文本名称",
                "text": {
                    "value": "文本"
                }
            },
            {
                "type": 1,
                "name": "网页名称",
                "web": {
                    "url": "http://www.test.com",
                    "title": "标题"
                }
            }
        ]
    },
    "to_invite": true,
    "external_position": "高级产品经理",
    "external_profile": {
        "external_corp_name": "企业简称",
        "external_attr": [
            {
                "type": 0,
                "name": "文本名称",
                "text": {
                    "value": "文本"
                }
            },
            {
                "type": 1,
                "name": "网页名称",
                "web": {
                    "url": "http://www.test.com",
                    "title": "标题"
                }
            },
            {
                "type": 2,
                "name": "测试app",
                "miniprogram": {
                    "appid": "wx8bd8012614784fake",
                    "pagepath": "/index",
                    "title": "my miniprogram"
                }
            }
        ]
    }
}

读取成员接口：

请求方式：GET（HTTPS）
请求地址：
https://qyapi.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&userid=USERID

参数名：

access_token 必须参数 调用接口凭证
userid 必须参数 成员UserID

更新成员：

请求方式：POST（HTTPS）
请求地址：
https://qyapi.weixin.qq.com/cgi-bin/user/update?access_token=ACCESS_TOKEN

删除成员：

请求方式：GET（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/user/delete?access_token=ACCESS_TOKEN&userid=USERID
参数名：
access_token 必须参数 调用接口凭证
userid 必须参数 成员UserID

批量删除

请求方式：POST（HTTPS）
请求地址：
https://qyapi.weixin.qq.com/cgi-bin/user/batchdelete?access_token=ACCESS_TOKEN

userid转openid（涉及红包）

该接口使用场景为企业支付，在使用企业红包和向员工付款时，需要自行将企业微信的userid转成openid。

注：需要成员使用微信登录企业微信或者关注微工作台（原企业号）才能转成openid;
如果是外部联系人，请使用外部联系人openid转换转换openid

获取访问用户身份

该接口用于根据code获取成员信息

请求方式：GET（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE
参数：
access_token 必须参数 调用接口凭证
code 必须参数 通过成员授权获取到的code