为了帮助开发者排查回调连接失败的问题,提供这个网络检测的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。 |