公众号
取消
中文
中文
EN
取消
  • 服务端 API

    • # 获取微信推送服务器IP

    调试工具

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

    接口英文名：getCallbackIp

    该接口用于获取微信推送服务器 ip 地址（向开发者服务器推送信息的微信服务器来源地址）

    如果开发者基于安全等考虑，需要获知微信服务器的IP地址列表，以便进行相关限制，可以通过该接口获得微信服务器IP地址列表或者IP网段信息。

    # 1. 调用方式

    # HTTPS 调用

    GET https://api.weixin.qq.com/cgi-bin/getcallbackip?access_token=ACCESS_TOKEN

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填说明
    access_tokenstring是接口调用凭证，可使用 access_token

    # 请求体 Request Payload

    无

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    ip_liststring微信服务器IP地址列表
    errcodenumber错误码
    errmsgstring错误信息

    # 4. 注意事项

    1. 由于出口 IP 及入口 IP 可能存在变动，建议用户每天请求接口1次，以便于及时更新IP列表。为了避免造成单点故障，强烈建议用户不要长期使用旧的 IP 列表作为 api.weixin.qq.com 的访问入口。
    2. 使用固定IP访问 api.weixin.qq.com 时，请开发者注意运营商适配，跨运营商访问可能会存在高峰期丢包问题。
    3. 由于出口 IP 及入口 IP 可能存在变动，建议用户每天请求接口 1 次，以便于及时更新 IP 列表。为了避免造成单点故障，强烈建议用户不要长期使用旧的IP列表作为 api.weixin.qq.com 的访问入口。

    # 5. 代码示例

    # 5.1 成功响应

    请求示例

    {}

    返回示例

    {
  "ip_list": [
    "106.55.206.146",
    "106.55.206.211"
  ]
}

    # 5.2 错误响应

    请求示例

    {}

    返回示例

    {
  "errcode": 40013,
  "errmsg": "invalid appid"
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码

    错误码错误描述解决方案
    40013invalid appid无效的AppID

    # 7. 适用范围

    本接口在不同账号类型下的可调用情况：
    小程序公众号服务号小游戏微信小店联盟带货机构带货助手第三方平台移动应用网站应用视频号助手多端应用
    ✔ ✔ ✔ ✔ ✔ ✔ ✔ 〇 ✔ ✔ ✔ ✔