微信企业号-整理 - 图文

注：你应该审慎配置管理组的权限，够用即好，权限过大会增加误操作可能性及信息安全隐患。

AccessToken是企业号的全局唯一票据，调用接口时需携带AccessToken。AccessToken需要用CorpID和Secret来换取，不同的Secret会返回不同的AccessToken。正常情况下AccessToken有效期为7200秒，有效期内重复获取返回相同结果，并自动续期。由于获取access_token的api调用次数非常有限，建议企业全局存储与更新access_token，频繁刷新access_token会导致api调用受限，影响自身业务。

三、通讯录管理之部门信息的维护

有AccessToken访问票据，就可以利用API来做很多事情了，包括组织结构的获取、创建、删除等等功能。

创建部门的官方接口定义如下所示。

?

请求说明 Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token=ACCESS_TOKEN

请求包结构体为:

{ \广州研发中心\ \ \ \} ? 参数说明 参数 必须 是 是 是 否 调用接口凭证 部门名称。长度限制为1~64个字节，字符不能包括\\:*?\｜ 父亲部门id。根部门id为1 在父部门中的次序值。order值小的排序靠前。 说明 access_token name parentid order id ?

否 权限说明

部门id，整型。指定时必须大于1，不指定时则自动生成 管理组须拥有父部门的管理权限。

? { \ \ \} 返回结果 第六章 微信企业号的通讯录管理开发之成员管理

成员的管理操作，包括创建、删除、更新、获取、获取部门成员几个操作要点。

一、成员的创建操作

首先必须创建一个部门组织结构，这是开发的前提，因为通讯录管理，也是基于一个组织机构下的，如上述介绍的组织结构层次一样。

可以在后台通过功能操作添加人员，也可以调用微信企业号API进行人员管理的操作。

创建人员的API定义如下所示。

?

请求说明 Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/user/create?access_token=ACCESS_TOKEN 请求包结构体为:

{ \ \张三\ \ \产品经理\ \ \ \ \ \ \爱好\旅游\卡号\} ? 参数说明 参数 必须 是 调用接口凭证 是 成员UserID。对应管理端的帐号，企业内必须唯一。长度为1~64个字节 说明 access_token userid name department position mobile gender 是 成员名称。长度为1~64个字节 否 成员所属部门id列表。注意，每个部门的直属成员上限为1000个 否 职位信息。长度为0~64个字节 否 手机号码。企业内必须唯一，mobile/weixinid/email三者不能同时为空 否 性别。1表示男性，2表示女性 email weixinid avatar_mediaid extattr 否 邮箱。长度为0~64个字节。企业内必须唯一 否 微信号。企业内必须唯一。（注意：是微信号，不是微信的名字） 否 成员头像的mediaid，通过多媒体接口上传图片获得的mediaid 否 扩展属性。扩展属性需要在WEB管理端创建后才生效，否则忽略未知属性的赋值 ? 权限说明

管理组须拥有指定部门的管理权限。

? { 返回结果 \ \} 二、成员的更新操作

成员的数据更新和创建操作类似，它的企业号定义如下所示。

?

请求说明 Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/user/update?access_token=ACCESS_TOKEN 请求包示例如下（如果非必须的字段未指定，则不更新该字段之前的设置值）:

{ \ \李四\ \ \后台工程师\ \ \ \ \ \ \ \爱好\旅游\卡号\}