接口线路类型一[集群IP接口-免费]
[接口地址1]
:当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址2]
:当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址3]
:当前负载【
优】 接口通讯【
正常】
复制
测速
接口线路类型二[域名接口-免费]
[接口地址]
:[自动分发到集群接口均衡负载,但可能因网络运营商DNS缓存如果某个集群接口发生故障会造成个别地区有1天左右的故障期]
复制
测速
接口线路类型三[超高稳定-最低24¥/月]
[彩钻接口]
:[专属接口+集群接口+备用接口,自动负载均衡,自动故障切换,全球CDN加速]
复制
测速
请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)
复制全部
复制参数
[POST]请求示例(请根据开发语言自行POST)
请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。
名称 |
参数 |
必填 |
说明 |
用户ID | id | 是 | 用户中心的数字ID,例:id=10000000 |
用户KEY | key | 是 | 用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2 |
地址 | host | 是 | PING地址,可以是域名或IP。如果对方服务器禁PING,则会失败。例:host=www.apihz.cn |
地域 | type | 否 | 指定访问地域,同地域下可能有多个节点,系统会随机选择其中一个节点执行。1=国内,2=香港,3=美国,默认国内。例:type=1 |
返回参数说明
名称 |
参数 |
说明 |
状态码 | code | 200成功,400错误 |
信息提示 | msg | 如果状态码返回400,则msg返回错误提示。 |
耗时 | time | PING耗时,单位毫秒。 |
PING地址 | host | 被PING的地址 |
PING实际地址 | realhost | 被PING的实际地址,例如有CDN的地址。 |
PINGIP | ip | 被PING的实际IP地址 |
节点地域 | dy | 检测节点所在地域 |
节点地址 | dz | 检测节点详细地址 |
返回数据示例
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:{"code":200,"time":"33.1","host":"www.apihz.cn","realhost":"bd-l7-online-qiniu-ipv6.s.vedcdnlb.com","ip":"125.64.35.108","dy":"国内","dz":"上海","msg":"ok"}
示例:{"code":200,"time":"49.7","host":"www.apihz.cn","realhost":"bd-l7-online-qiniu-ipv6.s.vedcdnlb.com","ip":"125.64.35.108","dy":"香港","dz":"香港-CN2","msg":"ok"}
示例:{"code":200,"time":"214","host":"www.apihz.cn","realhost":"bd-l7-online-qiniu-ipv6.s.vedcdnlb.com","ip":"223.86.125.112","dy":"美国","dz":"美国-硅谷","msg":"ok"}
更新记录
2024-08-05 22:29:15 - 新增接口。