当前位置:首页>python>第330讲:Python 和 VBA 两种技术路线放在一起对照讲 : 调用API接口拉取第三方数据

第330讲:Python 和 VBA 两种技术路线放在一起对照讲 : 调用API接口拉取第三方数据

  • 2026-09-09 15:44:26
第330讲:Python 和 VBA 两种技术路线放在一起对照讲 : 调用API接口拉取第三方数据

场景:从企业微信/飞书/钉钉API拉取审批记录或考勤数据

在企业日常自动化中,“拉数据”永远是最基础、也是最容易卡壳的一环。尤其是对接企业微信、飞书、钉钉这类办公平台的API时,很多同学都会遇到同一个问题:

“Python我写得挺顺,为什么到了Excel VBA里就各种报错?”

这一讲我们不只讲“怎么调接口”,而是把 Python 和 VBA 两种技术路线放在一起对照讲,让你真正理解:

  • REST API 的本质是什么

  • requests 为什么“看起来那么简单”

  • VBA 里 XMLHTTP / WinHttpRequest 到底在干什么

  • 同样一个接口,两种语言在实现上的差异与取舍

文中我会穿插真实可用的代码示例(Python + VBA),并且补充一些实战中非常容易踩坑的细节,尽量做到“拿过去就能改着用”。


一、先搞懂:我们在“调接口”时到底在干什么?

无论你是 Python 还是 VBA,本质都一样:

  1. 构造一个 HTTP 请求

    • URL(接口地址)

    • Method(GET / POST)

    • Headers(Content-Type、Authorization 等)

    • Body(POST 时的 JSON 参数)

  2. 通过网络发给对方服务器

  3. 接收返回结果

    • 状态码(200 / 400 / 401 / 500…)

    • Response Body(通常是 JSON)

  4. 解析返回的数据

    • JSON → Python dict / VBA Dictionary 或 JSON 解析库

  5. 写入业务系统

    • Excel 单元格

    • 数据库

    • 本地文件

也就是说,requests 和 XMLHTTP 只是在“发请求 + 收响应”这一步不同,后面的逻辑完全一致。


二、场景设定:拉取审批记录(以企业微信为例)

为了便于对照,我们用一个非常典型的真实场景:

从企业微信「审批」应用中,拉取指定时间段内的请假审批记录,并写入 Excel。

企业微信官方接口文档中,对应接口为:

POST https://qyapi.weixin.qq.com/cgi-bin/oa/getapprovalinfo?access_token=ACCESS_TOKEN

1. 前置条件(非常重要)

无论 Python 还是 VBA,下面这几步都绕不开:

  1. 创建企业微信自建应用

  2. 拿到 corpid、corpsecret

  3. 通过 gettoken接口换取 access_token

  4. 给应用授权「审批」相关权限

  5. 明确审批模板 ID(在管理后台查看)

access_token 有效期通常为 7200 秒,生产环境一定要缓存,不要每次请求都重新获取。

三、Python 实现:requests + JSON 解析

1. 安装依赖

pip install requests

2. 获取 access_token

import requestsCORP_ID = "你的corpid"CORP_SECRET = "你的corpsecret"def get_access_token():    url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={CORP_ID}&corpsecret={CORP_SECRET}"    resp = requests.get(url)    resp.raise_for_status()    data = resp.json()    if data["errcode"] != 0:        raise Exception(f"获取token失败:{data}")    return data["access_token"]

为什么这里看起来这么简单?

因为 requests.get()帮你封装了:

  • TCP 连接

  • HTTP 协议序列化

  • 编码处理

  • JSON 自动解码(resp.json())

你看到的是“业务代码”,不是“底层通信代码”。


3. 拉取审批记录

import timedef get_approval_info(access_token):    url = f"https://qyapi.weixin.qq.com/cgi-bin/oa/getapprovalinfo?access_token={access_token}"    payload = {        "starttime": int(time.mktime(time.strptime("2025-01-01 00:00:00", "%Y-%m-%d%H:%M:%S"))),        "endtime": int(time.mktime(time.strptime("2025-01-31 23:59:59", "%Y-%m-%d%H:%M:%S"))),        "cursor": 0,        "size": 100,        "filters": [            {                "key": "template_id",                "value": "审批模板ID"            }        ]    }    resp = requests.post(url, json=payload)    resp.raise_for_status()    return resp.json()

几个实战细节:

  • 企业微信时间戳是秒级,不是毫秒

  • json=payload会自动设置 Content-Type: application/json

  • raise_for_status()可以在 HTTP 非 200 时直接抛异常,方便调试


4. 写入 Excel(openpyxl 示例)

from openpyxl import Workbookdef write_to_excel(data):    wb = Workbook()    ws = wb.active    ws.append(["审批单号", "申请人", "审批状态", "提交时间"])    for sp_no in data.get("sp_no_list", []):        ws.append([sp_no, "", "", ""])    wb.save("approval.xlsx")

到这一步,Python 的完整链路已经跑通:鉴权 → 请求 → 解析 → 落地。


四、VBA 实现:WinHttpRequest + JSON 解析

很多人对 VBA 的印象是“老旧”“难用”,但在Excel 内嵌自动化这个场景里,它依然不可替代。

1. 引用 WinHttpRequest

在 VBA 编辑器中:

工具 → 引用 → Microsoft WinHTTP Services, version 5.1

如果你不想引用,也可以用后期绑定:

CreateObject("WinHttp.WinHttpRequest.5.1")

2. 获取 access_token(VBA)

Function GetAccessToken() As String    Dim http As Object    Set http = CreateObject("WinHttp.WinHttpRequest.5.1")    Dim corpid As String    Dim corpsecret As String    corpid = "你的corpid"    corpsecret = "你的corpsecret"    Dim url As String    url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=" & corpid & "&corpsecret=" & corpsecret    http.Open "GET", url, False    http.Send    If http.Status = 200 Then        Dim json As Object        Set json = JsonConverter.ParseJson(http.ResponseText)        If json("errcode") = 0 Then            GetAccessToken = json("access_token")        Else            Err.Raise vbObjectError + 1000, , "获取token失败:" & json("errmsg")        End If    Else        Err.Raise vbObjectError + 1001, , "HTTP错误:" & http.Status    End IfEnd Function

注意点:

  • VBA 没有内置 JSON 解析器

  • 推荐使用开源模块:VBA-JSON (JsonConverter.bas)

    下载后导入工程即可使用

  • http.ResponseText返回的是字符串,需要手动解析


3. 拉取审批记录(VBA)

Sub GetApprovalInfo()    Dim token As String    token = GetAccessToken    Dim http As Object    Set http = CreateObject("WinHttp.WinHttpRequest.5.1")    Dim url As String    url = "https://qyapi.weixin.qq.com/cgi-bin/oa/getapprovalinfo?access_token=" & token    Dim payload As String    payload = "{""starttime"":1735660800,""endtime"":1706742399,""cursor"":0,""size"":100,""filters"":[{""key"":""template_id"",""value"":""审批模板ID""}]}"    http.Open "POST", url, False    http.SetRequestHeader "Content-Type", "application/json"    http.Send payload    If http.Status = 200 Then        Dim json As Object        Set json = JsonConverter.ParseJson(http.ResponseText)        Dim ws As Worksheet        Set ws = ThisWorkbook.Sheets(1)        ws.Cells.Clear        ws.Range("A1").Value = "审批单号"        Dim i As Long        i = 2        Dim item As Variant        For Each item In json("sp_no_list")            ws.Cells(i, 1).Value = item            i = i + 1        Next item    Else        MsgBox "请求失败:" & http.Status    End IfEnd Sub

五、Python vs VBA:对照要点拆解

对比维度

Python (requests)

VBA (WinHttpRequest)

HTTP 调用

requests.get/post

Open → Send

JSON 支持

内置 json()

需引入 JSON 解析模块

可读性

极高

一般

错误处理

try/except+ HTTPStatus

Err.Raise+ Status

生态

丰富(pandas/openpyxl)

局限但紧贴 Excel

部署

需 Python 环境

Office 自带,零部署

一句话总结:

Python 胜在开发效率和生态;VBA 胜在“就在 Excel 里,不用折腾环境”。


六、实战经验:企业微信 / 飞书 / 钉钉 的共性问题

  1. Token 管理

    • 本地文件

    • Excel 隐藏表

    • SQLite / Access

    • 不要每次请求都拿 token

    • 可存在:

  2. 分页拉取

    • 企业微信:cursor

    • 飞书:page_token

    • 钉钉:next_cursor

    • 务必循环拉全量

  3. 时间戳差异

    • 企业微信 / 钉钉:秒

    • 飞书:毫秒

    • 写个统一转换函数,避免低级错误

  4. HTTPS & TLS

    • VBA 老版本可能不支持 TLS1.2

    • 必要时需打补丁或使用 WinHttp而非 XMLHTTP60

  5. 权限问题

    • 接口返回 48002 / 60011,多半是应用没授权


七、什么时候选 Python,什么时候用 VBA?

  • ✅ 选 Python:

    • 数据量大

    • 需要清洗、分析、入库

    • 定时任务(cron / Windows Task Scheduler)

    • 多系统联动(API → DB → BI)

  • ✅ 选 VBA:

    • 报表直接在 Excel 里

    • 使用者不懂 Python

    • 财务/行政同事只需点按钮

    • 不希望额外安装环境

实际项目中,两者往往是互补关系:

Python 负责“拉 & 洗”,VBA 负责“展示 & 填报”。


八、小结

这一讲我们从真实企业场景出发,完整演示了:

  • 如何用 Python + requests 拉取企业微信审批数据

  • 如何用 VBA + WinHttpRequest 实现同一功能

  • 两者在语法、结构、工程化上的本质差异

  • 企业微信 / 飞书 / 钉钉 API 的常见坑位

理解这些差异后,你就不会再纠结“哪个更好”,而是能根据业务场景、使用对象和维护成本做出合理选择。

九、随堂测验(5道选择题)

  1. 企业微信 API 的时间戳单位是:

    A. 毫秒

    B. 秒

    C. 微秒

    D. 纳秒

  2. Python requests 中,发送 JSON 参数的正确方式是:

    A. data=json.dumps(payload)

    B. json=payload

    C. body=payload

    D. params=payload

  3. VBA 中,若不引用 WinHTTP,可使用哪种方式创建对象?

    A. New WinHttpRequest

    B. CreateObject("WinHttp.WinHttpRequest.5.1")

    C. Server.CreateObject

    D. New MSXML2.XMLHTTP

  4. 企业微信获取 access_token 的接口返回字段是:

    A. token

    B. access_token

    C. auth_token

    D. t

  5. 以下关于 VBA 调用 API 的说法正确的是:

    A. VBA 内置 JSON 解析器

    B. WinHttpRequest 支持 HTTPS

    C. VBA 无法发送 POST 请求

    D. XMLHTTP60 一定比 WinHttpRequest 新


十、参考答案

  1. B

  2. B

  3. B

  4. B

  5. B


最新文章

随机文章