python3获取企微通讯录

原创

mob64ca12ee66e3 2024-09-28 06:18:35 ©著作权

©著作权归作者所有：来自51CTO博客作者mob64ca12ee66e3的原创作品，请联系作者获取转载授权，否则将追究法律责任

使用Python3获取企业微信通讯录指南

获取企业微信通讯录是许多应用程序和自动化工具的基础步骤。本文将指导你如何使用Python3实现这一目标，适合刚入行的小白来理解。

整体流程

在进行实际编码前，我们先理清整个流程，便于后续理解。下表展示了获取企业微信通讯录的关键步骤：

步骤	描述
第一步	创建企业微信应用并获取AgentId和Secret
第二步	获取Access Token
第三步	使用Access Token获取通讯录
第四步	处理和展示通讯录数据

流程图

我们可以用Mermaid语法表示上述流程图：

flowchart TD
    A[创建企业微信应用] --> B[获取Access Token]
    B --> C[获取通讯录]
    C --> D[处理和展示数据]

工作计划

为了能理清时间规划，我也根据每个步骤构建了一份渲染在Gantt图中的任务安排：

gantt
    title 获取企业微信通讯录计划
    dateFormat  YYYY-MM-DD
    section 第一步
    创建企业微信应用    :a1, 2023-10-01, 2d
    section 第二步
    获取Access Token    :a2, 2023-10-03, 2d
    section 第三步
    获取通讯录         :a3, 2023-10-05, 3d
    section 第四步
    处理和展示数据     :a4, 2023-10-08, 2d

实现步骤

第一步：创建企业微信应用

为了能够获取通讯录数据，你需要在企业微信官网注册并创建应用。取得应用的 AgentId 和 Secret 是必须的步骤。

第二步：获取Access Token

在企业微信中，接口调用的权限是通过Access Token来验证的。你需要通过以下请求获取Access Token：

import requests  # 导入requests库，用于发送HTTP请求

def get_access_token(corpid, secret):
    url = f"
    response = requests.get(url)  # 发送GET请求，获取Access Token
    data = response.json()  # 将响应内容转为JSON格式
    if 'access_token' in data:
        return data['access_token']  # 返回Access Token
    else:
        raise Exception("Unable to get access token")  # 抛出异常

说明：

这里的 corpid 是企业ID，secret 是应用的Secret，用于验证身份。

第三步：获取通讯录

有了Access Token后，你可以用它来获取通讯录信息：

def get_contacts(access_token):
    url = f"
    response = requests.get(url)  # 发送GET请求，以获取通讯录
    data = response.json()
    if 'userlist' in data:
        return data['userlist']  # 返回用户列表
    else:
        raise Exception("Unable to get contacts")  # 抛出异常

说明：

以上函数调用了企业微信的API，获取用户列表的接口。

第四步：处理和展示通讯录数据

一旦拿到了用户列表，你就可以处理并展示这些数据，例如打印出来或者以其他格式存储：

def display_contacts(contacts):
    for contact in contacts:
        print(f"姓名: {contact['name']}, 部门: {contact['department']}, 手机: {contact['mobile']}")  # 打印联系人信息

if __name__ == "__main__":
    corpid = 'YOUR_CORPID'  # 替换为你的corpid
    secret = 'YOUR_SECRET'  # 替换为你的secret
    access_token = get_access_token(corpid, secret)  # 获取Access Token
    contacts = get_contacts(access_token)  # 获取通讯录
    display_contacts(contacts)  # 展示通讯录

说明：