接口简介:
检测目标主机指定TCP端口是否开放。
请求地址:
https://cn.apihz.cn/api/wangzhan/port.php
请求方式:
POST或GET。
请求参数:
【名称】【参数】【必填】【说明】
【用户ID】【id】【是】【用户中心的数字ID,例:id=10000000】
【用户KEY】【key】【是】【用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2】
【目标主机】【host】【是】【目标主机IP地址或域名,例:host=49.234.56.78】
【端口】【port】【否】【指定要检测的端口,0-65536,默认80端口,例:port=80】
【地域】【type】【否】【指定检测节点,1=国内,2=香港,3=美国,默认国内。例:type=1】
返回参数:
【名称】【参数】【说明】
【状态码】【code】【200成功,400错误】
【信息提示】【msg】【返回提示。】
【检测主机】【host】【检测主机地址,返回传参的host。】
【端口】【port】【返回检测的端口。】
【端口状态】【state】【返回检测的端口状态,on为开放,off为关闭。注意,如果目标主机链接超过1秒视为该端口未开放。可以尝试切换检测点地域以获取更准确的检测信息。】
GET请求示例:
https://cn.apihz.cn/api/wangzhan/port.php?id=88888888&key=88888888&type=1&host=49.234.56.78&port=80
注意:示例里的ID与KEY为公共ID与KEY,共享每分钟调用频次限制,接口本身免费,请使用自己的ID与KEY,独享每分钟调用频次。每日调用无上限。
POST请求示例:
请根据开发语言自行POST。
返回数据示例:
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:{"code":200,"host":"www.apihz.cn","port":"3389","state":"off","msg":"关闭"}
示例:{"code":200,"host":"www.apihz.cn","port":"80","state":"on","msg":"开放"}