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

GET

https://qyapi.weixin.qq.com/cgi-bin/getcallbackip

服务端API企业内部开发第三方应用开发智慧硬件开发

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

权限说明：无限定。

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

请求示例

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"
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

🟢200成功

application/json

Body

ip_list

array[string]

必需

企业微信回调的IP段

errcode

integer

必需

错误码，0表示成功，非0表示调用失败

errmsg

string

必需

错误信息，调用失败会有相关的错误信息返回

🟢200错误

修改于 2022-11-30 06:14:41