企微获取成员userID

￡神魔★判官ぃ 2023-09-24 17:37 40阅读 0赞

[1、企微配置可信域名][1]  
[2、企微获取成员userID][2_userID]  
[3、企微获取用户敏感数据][3]  
[4、企微配置回调服务][4]

--------------------

### 文章目录 ###

*   *  一、简介
     *  二、获取token
     *   *  1、获取秘钥
         *  2、获取Token
     *  三、获取部门数据
     *   *  1、获取部门列表
         *  2、获取子部门ID列表
         *  3、获取单个部门详情
     *  四、获取成员信息
     *   *  1、读取成员
         *  2、获取部门成员
         *  3、获取部门成员详情

--------------------

## 一、简介 ##

**同步数据到企微：**

企业如果需要从自有的系统同步通讯录到企业微信，需要使用 [通讯录同步secret][secret]。

如果企业委托授权第三方服务商将通讯录从其他系统同步到企业微信，则需要企业授权“[通讯录编辑授权][Link 1]”给服务商。

**从企微获取数据：**

自建应用、代开发应用、第三方应用在提供功能时，往往需要获取通讯录，开发者可查阅成员、部门、标签相关的接口说明。

注意，自建应用、代开发应用、第三方应用仅能读取通讯录，不能编辑，且仅能读取可见范围内的通讯录。

[企微开发文档][Link 2]

https://developer.work.weixin.qq.com/document/path/90193

## 二、获取token ##

### 1、获取秘钥 ###

**获取corpid(企业ID)**

![在这里插入图片描述][fe747e56555a464cbd8c3039a81af0e6.png]

**获取corpsecret(应用的凭证密钥)**

![在这里插入图片描述][915bfc6466b94c15a96fd437b0b2e584.png]

### 2、获取Token ###

**请求方式：** GET（**HTTPS**）  
**请求地址：** https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET

https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=wwf219ef106b04c3c4&corpsecret=TBiRs37_qfwTgGA8HjQMskybQ6njS4IJS5VVhuzgeYU

**参数说明：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>corpid</td> 
   <td>是</td> 
   <td>企业ID，获取方式参考：<a href="https://developer.work.weixin.qq.com/document/path/91039#14953/corpid" rel="nofollow">术语说明-corpid</a></td> 
  </tr> 
  <tr> 
   <td>corpsecret</td> 
   <td>是</td> 
   <td>应用的凭证密钥，<strong>注意应用需要是启用状态</strong>，获取方式参考：<a href="https://developer.work.weixin.qq.com/document/path/91039#14953/secret" rel="nofollow">术语说明-secret</a></td> 
  </tr> 
 </tbody> 
</table>

返回结果：

{
        
       "errcode": 0,
       "errmsg": "ok",
       "access_token": "accesstoken000001",
       "expires_in": 7200
    }

**参数说明：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>errcode</td> 
   <td>出错返回码，为0表示成功，非0表示调用失败</td> 
  </tr> 
  <tr> 
   <td>errmsg</td> 
   <td>返回码提示语</td> 
  </tr> 
  <tr> 
   <td>access_token</td> 
   <td>获取到的凭证，最长为512字节</td> 
  </tr> 
  <tr> 
   <td>expires_in</td> 
   <td>凭证的有效时间（秒）</td> 
  </tr> 
 </tbody> 
</table>

**注意事项：**  
开发者需要缓存access\_token，用于后续接口的调用（注意：不能频繁调用gettoken接口，否则会受到频率拦截）。当access\_token失效或过期时，需要重新获取。

access\_token的有效期通过返回的expires\_in来传达，正常情况下为7200秒（2小时），有效期内重复获取返回相同结果，过期后获取会返回新的access\_token。  
由于企业微信每个应用的access\_token是彼此独立的，所以进行缓存时需要区分应用来进行存储。  
access\_token至少保留512字节的存储空间。  
企业微信可能会出于运营需要，提前使access\_token失效，开发者应实现access\_token失效时重新获取的逻辑。

**权限说明：**  
每个应用有独立的secret，获取到的access\_token只能本应用使用，所以每个应用的access\_token应该分开来获取

## 三、获取部门数据 ##

[官方页面][Link 3]

### 1、获取部门列表 ###

\*\*请求方式：\*\*GET（**HTTPS**）  
\*\*请求地址：\*\*https://qyapi.weixin.qq.com/cgi-bin/department/list?access\_token=ACCESS\_TOKEN&id=ID

https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token={
       {access_token}}&id=1980054547

**参数说明 ：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>access_token</td> 
   <td>是</td> 
   <td>调用接口凭证</td> 
  </tr> 
  <tr> 
   <td>id</td> 
   <td>否</td> 
   <td>部门id。获取指定部门及其下的子部门（以及子部门的子部门等等，递归）。 如果不填，默认获取全量组织架构</td> 
  </tr> 
 </tbody> 
</table>

### 2、获取子部门ID列表 ###

\*\*请求方式：\*\*GET（**HTTPS**）  
\*\*请求地址：\*\*https://qyapi.weixin.qq.com/cgi-bin/department/simplelist?access\_token=ACCESS\_TOKEN&id=ID

**参数说明 ：**

### 3、获取单个部门详情 ###

\*\*请求方式：\*\*GET（**HTTPS**）  
\*\*请求地址：\*\*https://qyapi.weixin.qq.com/cgi-bin/department/get?access\_token=ACCESS\_TOKEN&id=ID

**参数说明 ：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>access_token</td> 
   <td>是</td> 
   <td>调用接口凭证</td> 
  </tr> 
  <tr> 
   <td>id</td> 
   <td>是</td> 
   <td>部门id。</td> 
  </tr> 
 </tbody> 
</table>

https://qyapi.weixin.qq.com/cgi-bin/department/get?access_token={
       {access_token}}&id=4

## 四、获取成员信息 ##

[官方页面][Link 3]

### 1、读取成员 ###

\*\*请求方式：\*\*GET（**HTTPS**）  
\*\*请求地址：\*\*https://qyapi.weixin.qq.com/cgi-bin/user/get?access\_token=ACCESS\_TOKEN&userid=USERID

https://qyapi.weixin.qq.com/cgi-bin/user/get?access_token={
       {ACCESS_TOKEN}}&userid={
       {USERID}}

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>access_token</td> 
   <td>是</td> 
   <td>调用接口凭证</td> 
  </tr> 
  <tr> 
   <td>userid</td> 
   <td>是</td> 
   <td>成员UserID。对应管理端的帐号，企业内必须唯一。不区分大小写，长度为1~64个字节</td> 
  </tr> 
 </tbody> 
</table>

### 2、获取部门成员 ###

\*\*请求方式：\*\*GET（**HTTPS**）  
\*\*请求地址：\*\*https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access\_token=ACCESS\_TOKEN&department\_id=DEPARTMENT\_ID

**参数说明：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>access_token</td> 
   <td>是</td> 
   <td>调用接口凭证</td> 
  </tr> 
  <tr> 
   <td>department_id</td> 
   <td>是</td> 
   <td>获取的部门id</td> 
  </tr> 
 </tbody> 
</table>

> 如需获取该部门及其子部门的所有成员，需先获取该部门下的子部门，然后再获取子部门下的部门成员，逐层递归获取。

### 3、获取部门成员详情 ###

\*\*请求方式：\*\*GET（**HTTPS**）  
\*\*请求地址：\*\*https://qyapi.weixin.qq.com/cgi-bin/user/list?access\_token=ACCESS\_TOKEN&department\_id=DEPARTMENT\_ID

**参数说明：**

> 如需获取该部门及其子部门的所有成员，需先获取该部门下的子部门，然后再获取子部门下的部门成员，逐层递归获取。、

[1]: https://blog.csdn.net/lydms/article/details/128885914
[2_userID]: https://blog.csdn.net/lydms/article/details/128979067
[3]: https://blog.csdn.net/lydms/article/details/128991241
[4]: https://blog.csdn.net/lydms/article/details/132385737
[secret]: https://developer.work.weixin.qq.com/document/path/90193#10013/%E6%9C%AF%E8%AF%AD%E4%BB%8B%E7%BB%8D
[Link 1]: https://developer.work.weixin.qq.com/document/path/90193#40392
[Link 2]: https://developer.work.weixin.qq.com/document/path/90193
[fe747e56555a464cbd8c3039a81af0e6.png]: https://img-blog.csdnimg.cn/fe747e56555a464cbd8c3039a81af0e6.png
[915bfc6466b94c15a96fd437b0b2e584.png]: https://img-blog.csdnimg.cn/915bfc6466b94c15a96fd437b0b2e584.png
[Link 3]: https://developer.work.weixin.qq.com/document/path/90200