企微获取成员userID

gKAh11OJpGE · 发表于 2023-3-11 11:32:15

一、企微设置可托域名
二、企微获得成员userID
三、企微获得用户敏感数据

文章目次

1、简介

共步数据到企微：
企业假设需要从自有的体系共步通信录到企业微疑，需要使用通信录共步secret。
假设企业拜托受权第三圆效劳商将通信录从其余体系共步到企业微疑，则需要企业受权“通信录编纂受权”给效劳商。
从企微获得数据：
自修使用、代开辟使用、第三圆使用正在供给功用时，常常需要获得通信录，开辟者可查阅成员、部分、标签相干的交心分析。
留神，自修使用、代开辟使用、第三圆使用仅能读与通信录，不克不及编纂，且仅能读与看来范畴内乱的通信录。
企微开辟文档

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

复造代码

2、获得token

一、获得秘钥

获得corpid(企业ID)

获得corpsecret(使用的凭据稀钥)

二、获得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

复造代码

参数分析：

参数	必需	分析
corpid	是	企业ID，获得方法参照：术语分析-corpid
corpsecret	是	使用的凭据稀钥，留神使用需要是启动形状，获得方法参照：术语分析-secret

前去成果：

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

复造代码

参数分析：

参数	分析
errcode	堕落前去码，为0暗示胜利，非0暗示挪用失利
errmsg	前去码提醒语
access_token	获得到的凭据，最少为512字节
expires_in	凭据的有用时间（秒）

留神事变：
开辟者需要慢存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该当分隔去获得
3、获得部分数据

民间页里
一、获得部分列表

**恳求方法：**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

复造代码

参数分析：

参数	必需	分析
access_token	是	挪用交心凭据
id	可	部分id。获得指定部分及其下的子部分（和子部分的子部分等等，递回）。假设没有挖，默认获得齐质构造架构

二、获得子部分ID列表

**恳求方法：**GET（HTTPS）
**恳求地点：**https://qyapi.weixin.qq.com/cgi-bin/department/simplelist?access_token=ACCESS_TOKEN&id=ID
参数分析：

参数	必需	分析
access_token	是	挪用交心凭据
id	可	部分id。获得指定部分及其下的子部分（和子部分的子部分等等，递回）。假设没有挖，默认获得齐质构造架构

三、获得单个部分概略

**恳求方法：**GET（HTTPS）
**恳求地点：**https://qyapi.weixin.qq.com/cgi-bin/department/get?access_token=ACCESS_TOKEN&id=ID
参数分析：

参数	必需	分析
access_token	是	挪用交心凭据
id	是	部分id。

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

复造代码

4、获得成员疑息

民间页里
一、读与成员

**恳求方法：**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}}

复造代码

参数	必需	分析
access_token	是	挪用交心凭据
userid	是	成员UserID。对于应办理真个帐号，企业内乱必需唯一。没有辨别巨细写，少度为1~64个字节

二、获得部分成员

**恳求方法：**GET（HTTPS）
**恳求地点：**https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID
参数分析：

参数	必需	分析
access_token	是	挪用交心凭据
department_id	是	获得的部分id

如需获得该部分及其子部分的统统成员，需先获得该部分下的子部分，而后再获得子部分下的部分成员，逐层递回获得。

三、获得部分成员概略

**恳求方法：**GET（HTTPS）
**恳求地点：**https://qyapi.weixin.qq.com/cgi-bin/user/list?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID
参数分析：