为了帮助开发者排查回调连接失败的问题,提供这个网络检测的API。它可以对开发者 URL 做域名解析,然后对所有 IP 进行一次 ping 操作,得到丢包率和耗时。

HTTP Post请求: https://api.weixin.qq.com/cgi-bin/callback/check?access_token=ACCESS_TOKEN

请求 JSON 格式:

{
    "action": "all", 
    "check_operator": "DEFAULT"
}

参数说明

参数 是否必须 说明
action 执行的检测动作,允许的值:dns(做域名解析)、ping(做 ping 检测)、all(dns和 ping 都做)
check_operator 指定平台从某个运营商进行检测,允许的值:CHINANET(电信出口)、UNICOM(联通出口)、CAP(腾讯自建出口)、DEFAULT(根据 ip 来选择运营商)

返回 Json 格式

{
    "dns": [
        {
            "ip": "111.161.64.40", 
            "real_operator": "UNICOM"
        }, 
        {
            "ip": "111.161.64.48", 
            "real_operator": "UNICOM"
        }
    ], 
    "ping": [
        {
            "ip": "111.161.64.40", 
            "from_operator": "UNICOM", 
            
            
            "package_loss": "0%", 
            "time": "23.079ms"
        }, 
        {
            "ip": "111.161.64.48", 
            "from_operator": "UNICOM", 
            "package_loss": "0%", 
            "time": "21.434ms"
        }
    ]
}

参数说明

参数 说明
dns dns结果列表
dns.ip 解析出来的ip
dns.real_operator ip对应的运营商
ping ping结果列表
ping.ip ping的ip,执行命令为ping ip –c 1-w 1 -q
ping.from_operator ping的源头的运营商,由请求中的check_operator控制
ping.package_loss ping的丢包率,0%表示无丢包,100%表示全部丢包。因为目前仅发送一个 ping 包,因此取值仅有0%或者100%两种可能。
ping.time ping的耗时,取 ping 结果的 avg 耗时。

错误码(仅列出本 API 新增错误码)

错误码 说明
40202 不正确的action
40203 不正确的check_operator
40201 不正确的URL,一般是开发者未设置回调URL。