企业微信开发：自建应用：获取企业微信IP段（用于防火墙配置）

概述

在企业微信开发流程中，为了确保与企业微信API的网络通信安全，并适应防火墙配置要求，开发者需要获取企业微信API服务的IP地址范围。这样，仅允许与企业微信官方通信的合法请求通过防火墙，从而保障数据传输的安全性。

企业微信IP地址分类

在与企业微信的交互过程中，信息传递涉及两个方向：

1. 从企业服务器向企业微信服务器发送消息；
2. 从企业微信服务器向企业服务器推送回调信息。

这两类信息传输分别对应着企业微信中的两组服务器 —— API服务器和回调服务器，它们可能拥有不同的IP地址段。因此，为了实现双向通信的畅通无阻，企业需要将这两组IP地址段都配置到防火墙中：

企业微信服务器中，API服务器接收企业发送的信息，回调服务器发送信息给企业服务器，分别对应着两条信息传递路径。这两组服务器，可能会有不同的IP地址；所以，为了能和企业微信服务器进行双向通信，需要将两组IP端，都配置到防火墙中，以确保通信畅通。

• 企业微信接口IP段（关联于API服务器）；
• 企业微信回调IP段（关联于回调服务器）；

获取企业微信IP段的方法

企业微信官方提供了两个专门的接口来获取这两个IP地址段，具体调用方法在官方文档中有详细说明：

获取企业微信接口IP段

• 请求方式：GET（HTTPS）
• 请求地址： https://qyapi.weixin.qq.com/cgi-bin/get_api_domain_ip?access_token=ACCESS_TOKEN

获取企业微信接口IP段

• 请求方式：GET（HTTPS）
• 请求地址： https://qyapi.weixin.qq.com/cgi-bin/getcallbackip?access_token=ACCESS_TOKEN

官方文档链接

• 企业微信接口IP段：获取企业微信接口IP段

• 企业微信回调IP段：获取企业微信回调IP段
  

注意

企业微信的IP地址段可能会发生变更，当变更发生时，新旧IP段会并行保留一段时间以保证平稳过渡。因此，企业微信官方建议开发者每天定时查询和更新IP地址段，并调整防火墙设置，避免因IP段变化导致通信中断。

接口调用示例

以下是接口调用示例（引用自官方文档，实际使用时请参考最新官方文档）：

• 获取企业微信回调IP段

• 获取企业微信回调IP段