URI

/v2/site/info/${task_id}.json

Method

GET

参数说明

参数名

必填

描述


默认值

access_token

必填




task_id

必填

网站的任务ID



成功结果: 

HTTP结果

{

  “task_name”: “302httptest”,

  “url”: “http://ik.webex.com.cn”,

  “frequency”: “60”,

  “retry”: “1”,

  “history”: “1”,

  “submit_method”: “0”,

  “pattern_str”: “”,

  “pattern_type”: “0”,

  “cookies”: “”,

  “header”: “”,

  “http_user”: “”,

  “http_pwd”: “”,

  “ip”: “”,

  “redirect”: “on”,

  “redirect_times”: “3”,

  “param”: “”,

  “task_type”: “http”,

  “use_dns_ip”: “0”,

  “metric_ip”: null,

  “use_dns_domain”: “0”,

  “metric_domain”: null,

  “use_dns_server”: “0”,

  “class_id”: “”,

  “group_id”: “2”,

  “monitors”: {

“1”: “陕西西安电信”,

………….

  },

    "alert_setting_list": [

         {

            "user_id": "4",

             "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        },

        {

            "user_id": "16",

            "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        }    ]

   }

 

 

}

 

SMTP结果

{

  “task_name”: “smtp”,

  “host”: “smpt.sina.com.cn”,

  “smtp_port”: “25”,

  “frequency”: “2”,

  “retry”: “1”,

  “history”: “0”,

  “redirect”: “”,

  “param”: null,

  “task_type”: “smtp”,

  “use_dns_ip”: “0”,

  “metric_ip”: null,

  “use_dns_domain”: “0”,

  “metric_domain”: null,

  “use_dns_server”: “0”,

  “class_id”: “”,

  “group_id”: “2”,

  “monitors”: {

“1”: “陕西西安电信”,

………..

  },

    "alert_setting_list": [

         {

            "user_id": "4",

             "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        },

        {

            "user_id": "16",

            "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        }    ]

   }

 

}

 

UDP结果

{

  “task_name”: “udp”,

  “host”: “www.baidu.com”,

  “udp_port”: “53”,

  “frequency”: “2”,

  “retry”: “1”,

  “history”: “0”,

  “request_format”: “0”,

  “request_str”: “<cr></cr>”,

  “pattern_format”: “0”,

  “pattern_str”: “”,

  “redirect”: “”,

  “param”: null,

  “task_type”: “udp”,

  “use_dns_ip”: “0”,

  “metric_ip”: null,

  “use_dns_domain”: “0”,

  “metric_domain”: null,

  “use_dns_server”: “0”,

  “class_id”: “”,

  “group_id”: “2”,

  “monitors”: {

“1”: “陕西西安电信”,

………

  },

   "alert_setting_list": [

         {

            "user_id": "4",

             "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        },

        {

            "user_id": "16",

            "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        }    ]

   }

 

 

}

 

TCP结果

{

  “task_name”: “tcp”,

  “host”: “www.baidu.com”,

  “tcp_port”: “80”,

  “frequency”: “2”,

  “retry”: “1”,

  “history”: “0”,

  “redirect”: “”,

  “param”: null,

  “task_type”: “tcp”,

  “use_dns_ip”: “0”,

  “metric_ip”: null,

  “use_dns_domain”: “0”,

  “metric_domain”: null,

  “use_dns_server”: “0”,

  “class_id”: “”,

  “group_id”: “2”,

  “monitors”: {

“1”: “陕西西安电信”,

………

  },

    "alert_setting_list": [

         {

            "user_id": "4",

             "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        },

        {

            "user_id": "16",

            "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        }    ]

   }

 

 

}

 

DNS结果

{

  “task_name”: “dns”,

  “frequency”: “2”,

  “domain”: “http://www.baidu.com”,

  “retry”: “1”,

  “history”: “0”,

  “dns_type”: “1”,

  “use_dns_ip”: “0”,

  “metric_ip”: “null”,

  “use_dns_server”: “0”,

  “dns_server”: “”,

  “redirect”: “”,

  “param”: null,

  “task_type”: “dns”,

  “use_dns_domain”: “0”,

  “metric_domain”: “null”,

  “class_id”: “”,

  “group_id”: “2”,

  “monitors”: {

“1”: “陕西西安电信”,

……..

  },

    "alert_setting_list": [

         {

            "user_id": "4",

             "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        },

        {

            "user_id": "16",

            "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        }    ]

   }

 

 

}

 

FTP结果

{

  “task_name”: “ftp”,

  “host”: “www.baidu.com”,

  “ftp_port”: “21”,

  “frequency”: “2”,

  “retry”: “1”,

  “history”: “0”,

  “ftp_anonymous”: “0”,

  “ftp_user”: “”,

  “ftp_pwd”: “”,

  “redirect”: “”,

  “param”: null,

  “task_type”: “ftp”,

  “use_dns_ip”: “0”,

  “metric_ip”: null,

  “use_dns_domain”: “0”,

  “metric_domain”: null,

  “use_dns_server”: “0”,

  “class_id”: “”,

  “group_id”: “2”,

  “monitors”: {

“1”: “陕西西安电信”,

……

  },

    "alert_setting_list": [

         {

            "user_id": "4",

             "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        },

        {

            "user_id": "16",

            "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        }    ]

   }

 

 

}

 

Ping结果

{

  “task_name”: “ping”,

  “host”: “www.baidu.com”,

  “frequency”: “1”,

  “retry”: “1”,

  “history”: “0”,

  “redirect”: “”,

  “param”: null,

  “task_type”: “ping”,

  “use_dns_ip”: “0”,

  “metric_ip”: null,

  “use_dns_domain”: “0”,

  “metric_domain”: null,

  “use_dns_server”: “0”,

  “class_id”: “”,

  “group_id”: “2”,

  “monitors”: {

“1”: “陕西西安电信”,

………..

  },

  "alert_setting_list": [

         {

            "user_id": "4",

             "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        },

        {

            "user_id": "16",

            "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        }    ]

   }

 

 

}

 

网页性能结果

{

  “task_name”: “网页性能”,

  “url”: “http://www.baidu.com”,

  “frequency”: “15”,

  “retry”: “1”,

  “cookies”: “”,

  “header”: “”,

  “ip”: “”,

  “redirect”: “”,

  “param”: null,

  “task_type”: “site”,

  “use_dns_ip”: “0”,

  “metric_ip”: null,

  “use_dns_domain”: “0”,

  “metric_domain”: null,

  “use_dns_server”: “0”,

  “class_id”: “”,

  “group_id”: “2”,

  “monitors”: {

“1”: “陕西西安电信”,

………

  },

  “history”: “0” ,

    "alert_setting_list": [

         {

            "user_id": "4",

             "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        },

        {

            "user_id": "16",

            "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        }    ]

   }

 

 

}

 

TraceRoute结果

{

  “task_name”: “iptraceroutetrue”,

  “host”: “180.150.177.153”,

  “frequency”: “2”,

  “retry”: “1”,

  “history”: “1”,

  “redirect”: “”,

  “param”: null,

  “task_type”: “traceroute”,

  “use_dns_ip”: “0”,

  “metric_ip”: null,

  “use_dns_domain”: “0”,

  “metric_domain”: null,

  “use_dns_server”: “0”,

  “class_id”: “17966”,

  “group_id”: “2”,

  “monitors”: {

“1”: “陕西西安电信”,

………

  },

    "alert_setting_list": [

         {

            "user_id": "4",

             "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        },

        {

            "user_id": "16",

            "alert_settings": {

                "email": "0",

                "sms": "0"

            }

        }    ]

   }

 

}

  


返回项

类型

描述

task_name

String

监控项目名称

task_type

String

任务类型[http,dns….]

frequency

String

监控频率(分钟)

retry

String

重试几次告警(1-3次)

monitors

String

使用的监测点(监测点之间以半角逗号隔开.可通过/v2/site/monitors.json接口获得)

class_id

String

分类ID

history

Enum

记录节点故障快照[0-关闭,1-开启]

 alert_setting_list Array 告警提醒用户设置列表
   -- user_id String 告警通知用户id
   -- alert_setting Array 告警通知类型 email邮箱通知,push APP通知, voice 语音通知,sms短信通知,wechat微信通知,remind 连续告警通知  值0不启用,1为启用

以下为HTTP所选项

url

String

URL

pattern_str

String

匹配响应内容

pattern_type

Enum

匹配方式[0-包含匹配内容,1-不包含匹配内容]

cookies

String

Cookies

http_user

String

HTTP验证用户名

http_pwd

String

HTTP验证密码

ip

String

服务器IP

submit_method

Enum

HTTP请求方式[0-GET,1-POST,2-HEAD]

redirect

Enum

重定向[on-勾选,off-未勾选] 默认不勾选

param

String

POST请求方式提交内容

header

String

HTTP请求头信息

以下为DNS所选项

domain

String

域名

dns_type

String

DNS查询类型

use_dns_domain

Enum

匹配域名地址[1-指定域名地址,0-不指定域名地址]

metric_domain

String

指定域名地址(多个域名地址请用;隔开)

use_dns_server

String

指定DNS服务器[1-指定,0-不指定]

dns_server

String

DNS服务器地址

use_dns_ip

Enum

匹配IP地址[1-指定IP地址,0-不指定IP地址]

metric_ip

String

指定IP地址(多个IP地址请用;隔开)

以下为FTP所选项

host

String

主机域名或IP

ftp_port

String

FTP端口

ftp_anonymous

Enum

FTP身份验证[0-需要身份验证 ,1-匿名登录]

ftp_user

String

FTP用户名

ftp_pwd

String

FTP密码

以下为TCP所选项

tcp_port

String

TCP端口

host

String

主机域名或IP

以下为UDP所选项

host

String

主机域名或IP

udp_port

String

UDP端口

request_format

Enum

UDP请求内容格式[0-Binary格式,1-文本格式]

request_str

String

UDP请求内容

pattern_format

Enum

匹配响应内容格式[0-Binary格式,1-文本格式]

pattern_str

String

匹配相应内容

以下为SMTP所选项

host

String

SMTP主机

smpt_port

String

SMTP端口

以下为TraceToute所选项

host

String

主机域名或IP

失败结果:

{

  "code": 400,

  "msg": "您没有权限查看该任务!"

}

返回项

类型

描述

code

String

状态码

msg

String

状态描述




调用示例:

curl -s 'https://api.jiankongbao.com/v2/site/info/690409.json?access_token=725eb00316f4619ece5e94776a67f5ea70348e84'