回调配置-获取企业微信服务器的ip段

GET

/cgi-bin/getcallbackip

企业微信在回调企业指定的URL时，是通过特定的IP发送出去的。如果企业需要做防火墙配置，那么可以通过这个接口获取到所有相关的IP段。IP段有变更可能，当IP段变更时，新旧IP段会同时保留一段时间。建议企业每天定时拉取IP段，更新防火墙设置，避免因IP段变更导致网络不通。

权限说明：无限定。

若调用失败，会返回errcode及errmsg（判断是否调用失败，根据errcode存在并且值非0）

请求参数

Query 参数

🟢200成功

application/json

Body

🟢200错误

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://qyapi.weixin.qq.com/cgi-bin/getcallbackip?access_token='

响应示例

200 - 成功 - 成功示例

{
    "ip_list": [
        "1.2.3.4",
        "2.3.3.3"
    ],
    "errcode": 0,
    "errmsg": "ok"
}

修改于 2025-09-22 07:18:27