任务创建
方法:POST
Content-Type:application/x-www-form-urlencoded
https://network.tingyun.com/network-report-data/task-config/add-json-authkey
API依赖关系
detail_id:需要请求套餐列表接口获取对应的套餐ID。
probgrp_id:需要请求节点组列表接口获取对应的节点ID。
API调用流程图
- 调用套餐列表API,获取关键参数detail_id。
- 调用节点组列表API,获取关键参数probgrp_id。
- 调用任务创建API实现任务创建。
请求参数
固网
页面监测
| 字段名 | 类型 | 必填 | 选项 | 描述 |
|---|---|---|---|---|
| authkey | String | 是 | -- | 授权码 |
| type | Int | 是 | 1:页面类型 | 任务类型 |
| detail_id | Int | 是 | -- | 套餐id |
| name | String | 是 | 多个任务名称之间以','间隔,任务名称的个数必须与URL的个数相同 | 任务名称 |
| url | String | 是 | 多个任务URL之间以','间隔,URL的个数必须与任务名称的个数相同 | 任务URL |
| expire | Date | 是 | yyyy-MM-dd | 任务有效期 |
| probgrp_id | Int | 是 | -- | 节点组ID |
| Interval | Int | 是 | 60:1分钟 300:5分钟 600:10分钟 900:15分钟 1800:30分钟 3600:1小时 7200:2小时 10800:3小时 14400:4小时 21600:6小时 28800:8小时 43200:12小时 86400:24小时 | 监测频率 |
| if_bind | Int | 否 | 0:否,1:是 | 是否开启绑定任务(批量创建时使用) |
| bs_type | String | 否 | I:IE C:Chrome F:Firefox | 浏览器内核 |
| timeout | Int | 否 | 范围:1~300,默认:120 | 超时时间 |
| ext_wait | Int | 否 | 范围:0~5,默认:0 | 额外等待时间 |
| client_redirects | Int | 否 | 默认:0 | 客户端重定向次数 |
| do_ping | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行ping监测 |
| ping_size | Int | 否 | 范围:0~65500 | ping包大小 |
| ping_count | Int | 否 | 范围:0~50 | ping次数 |
| if_tcp_ping | Int | 否 | 0:否,1:是,默认:0 | 是否tcpping |
| rst_ok | Int | 否 | 0:否,1:是 | 当TCP连接被重置时(TCP Ping),视为Ping已到达 |
| do_nslookup | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行nslookup监测 |
| do_tracert | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行traceroute监测 |
| do_scrshot | Int | 否 | 0:不开启,1:当出现页面错误时执行,2:当出现页面错误或内容错误时执行,3:总是执行,默认:0 | 执行页面截屏 |
| do_src | Int | 否 | 0:不开启,1:页面错误时上传源代码,2:页面错误和内容错误时上传源代码,3:总是上传源代码,默认:0 | 上传HTML源代码 |
| do_head | Int | 否 | 0:不开启,1:仅保留主元素和错误元素的头信息,2:保留所有元素响应头信息,3:保留所有元素请求头和响应头信息,默认:0 | 保留HTTP头 |
| do_pcap | Int | 否 | 0:不开启,1:当出现页面错误时执行,2:当出现页面错误或内容错误时执行,3:总是执行,默认:0 | 是否抓包 |
| check_dns | Int | 否 | 0:不检查,1:检查,默认:1 | 是否检查dns服务器设置 |
| support_ipv6 | Int | 否 | 0:IPV4/IPV6混合节点,1:只选IPV6节点,2:只选IPV4节点,默认:2 | 指定支持ipv6的节点 |
| dns_match | Int | 否 | 0:自动,1:与节点协议一致,默认:0 | DNS协议 |
| lan_task | Int | 否 | 0:否,1:是,默认:0 | 是否为内网监测 |
| if_bandwidth | Int | 否 | 0:不启用,1:启用,默认:0 | 是否开启带宽选项 |
| bandwidth_min | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最小值 |
| bandwidth_max | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最大值 |
| ignoreHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 排除监测节点(按ID) |
| ignoreProbeStr | String | 否 | 填写多个ip请以换行符\n间隔 | 排除监测节点(按IP) |
| containsHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 包含监测节点(按ID) |
| containsProbeIpStr | String | 否 | 填写多个ip请以换行符\n间隔 | 包含监测节点(按IP) |
| os_bs_filter_mode | Int | 否 | 0:排除,1:包含,默认:1 | 按操作系统/浏览器筛选监测节点 |
| osBsFilterStr | String | 否 | W5.1.1:Windows XP W5.2.2:Windows 2003 W6.0.1:Windows 2008 W6.1.1:Windows 7 W6.2.1:Windows 8 W6.1.99:Windows 2012 W6.1.2:Windows 2008 R2 W10.0.1:Windows 10 I:所有,I6:IE6,I7:IE7,I8:IE8,I9:IE9,I10:IE10,I11:IE11 C:所有,C55:Chrome 55,C79:Chrome 79 举例:排除Windows XP的IE6就填写W5.1.1;I6 | 按操作系统/浏览器筛选监测节点 |
| req_plugin_opt | String | 否 | V:Flash Player D:Flash Audio Player M:Windows Media Player R:Real player Q:QuickTime(Alpha Testing) L:SilverLight | 仅选取安装了指定客户端插件的监测节点 |
| scatter | Int | 否 | 0:不启用,1:启用,默认:1 | 分散监测 |
| logon_user | Int | 否 | 0:否,1:是,默认:0 | 使用LocalStorage |
| do_scroll_page | Int | 否 | 0:不开启,1:开启,默认:0 | 支持滚屏 |
| log_ssl_info | String | 否 | 1:是,0:否,当前只支持谷歌浏览器 | 是否开启证书监控 |
| end_to_end | Int | 否 | 0 不启用,1 启用,默认0 | 是否开启听云端到端服务 |
| disable_dnsclient | Int | 否 | 0:不禁用,1:禁用,默认:1 | 禁用监测节点的DNS Client服务(DNS缓存) |
| first_main | Int | 否 | 0:否,1:是,默认:0 | 首元素为主元素 |
| script_enable | Int | 否 | 0:不启用,1:启用,默认:1 | 允许客户端运行脚本 |
| popup_window | Int | 否 | 0:不启用,1:启用,默认:1 | 允许弹出窗口 |
| tstotal_calc_way | Int | 否 | 0:否,1:是,默认:0 | 忽略客户端时间 |
| scrfirst_width | Int | 否 | -- | 首屏尺寸(宽) |
| scrfirst_length | Int | 否 | -- | 首屏尺寸(高) |
| first_screen_Interval | Int | 否 | 100:100ms,150:150ms,200:200ms,250:250ms,300:300ms,400:400ms,500:500ms,0:默认 | 首屏监测时间间隔 |
| host_dispatch_method | Int | 否 | 0:轮询,1:随机,默认:0 | 自定义hosts(IP-域名映射表) |
| hosts | String | 否 | 自定义hosts,支持多个,批量创建任务时,无','间隔时,所有任务公用一份hosts配置,多个','间隔时,必须与任务名称的数量一致,否则视为非法的数据 多个host以换行符进行间隔 | 自定义hosts配置 |
| enable_quic | Int | 否 | 0:否,1:是,默认:0(提示:浏览器内核请勾选Chrome) | 是否指定quic |
| quic_version | Int | 否 | 0:自动,46:46,默认:0 | quic版本 |
| quic_hosts | String | 否 | -- | quic域名列表 |
| http_auth_user | String | 否 | -- | http认证用户名 |
| http_auth_pass | String | 否 | -- | http认证密码 |
| http_compression | Int | 否 | 0:不启用,1:启用,默认:1 | 启用HTTP压缩 |
| user_agent | Int | 否 | 0:否,1:是,默认:1 | 使用听云Network User-Agent |
| accept_lang | String | 否 | zh-CN:简体中文 zh-TW:繁体中文 en:英文 默认:zh-CN | 浏览器语言 |
| custom_head | String | 否 | 自定义Http头,支持多个,批量创建任务时,无','间隔时,所有任务公用一份自定义Http头配置,多个','间隔时,必须与任务名称的数量一致,否则视为非法的数据 多个自定义Http头以换行符进行间隔 | 自定义Http头 |
| reqed_text | String | 否 | -- | 预期正确文本 |
| err_text | String | 否 | -- | 错误文本 |
| block_urls | String | 否 | -- | 监测时排除以下元素url |
| accept_urls | String | 否 | -- | 监测时仅访问以下元素url |
| elem_regex | String | 否 | -- | 元素URL合并规则 |
| check_hijacking | Int | 否 | 0:不开启,1:开启,默认:0 | 是否开启劫持检测 |
| hijack_host_white_list | String | 否 | -- | IP白名单(DNS劫持) |
| hijack_cname_level | Int | 否 | 范围:0-100 | cname层级 |
| hijack_url_white_list | String | 否 | -- | 域名白名单(页面劫持) |
| Intelligent_dispatch | Int | 否 | 0:否,1:是,默认:0 | 是否智能降噪 |
| dispatch_by_city_isp | Int | 否 | 0:否,1:是,默认:0 | 当某城市运营商SLA不足时,调度到同省份的省会城市运营商执行(国外调度到同国家) |
| dispatch_by_error | Int | 否 | 0:否,1:是,默认:0 | 出现页面错误重发(重发一次) |
| dispatch_by_indicator | Int | 否 | 0:否,1:是,默认:0 | 性能指标超阈值重发(重发一次) |
| dispatch_indicator_field | String | 否 | T:总下载时间 D:DNS时间 C:建立连接时间 S:SSL握手时间 F:首包时间 O:内容下载时间 L:客户端时间 U:首屏时间 默认:T | 性能指标超阈值重发指标 |
| dispatch_indicator_threshold | double | 否 | -- | 性能指标超阈值 |
文件监测
| 字段名 | 类型 | 必填 | 选项 | 描述 |
|---|---|---|---|---|
| authkey | String | 是 | -- | 授权码 |
| type | Int | 是 | 12:PC文件下载 | 任务类型 |
| detail_id | Int | 是 | -- | 套餐id |
| name | String | 是 | 多个任务名称之间以','间隔,任务名称的个数必须与URL的个数相同 | 任务名称 |
| url | String | 是 | 多个任务URL之间以','间隔,URL的个数必须与任务名称的个数相同 | 任务URL |
| request_type | Int | 否 | 0:GET,1:POST | http请求方法 |
| expire | Date | 是 | yyyy-MM-dd | 任务有效期 |
| probgrp_id | Int | 是 | -- | 节点组ID |
| Interval | Int | 是 | 60:1分钟 300:5分钟 600:10分钟 900:15分钟 1800:30分钟 3600:1小时 7200:2小时 10800:3小时 14400:4小时 21600:6小时 28800:8小时 43200:12小时 86400:24小时 | 监测频率 |
| if_bind | Int | 否 | 0:否,1:是 | 是否开启绑定任务(批量创建时使用) |
| bs_type | String | 否 | I:IE C:Chrome | 浏览器内核 |
| timeout | Int | 否 | 范围:1~300,默认:120 | 超时时间 |
| ext_wait | Int | 否 | 范围:0~5,默认:0 | 额外等待时间 |
| client_redirects | Int | 否 | 默认:0 | 客户端重定向次数 |
| do_ping | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行ping监测 |
| ping_size | Int | 否 | 范围:0~65500 | ping包大小 |
| ping_count | Int | 否 | 范围:0~50 | ping次数 |
| if_tcp_ping | Int | 否 | 0:否,1:是,默认:0 | 是否tcpping |
| rst_ok | Int | 否 | 0:否,1:是 | 当TCP连接被重置时(TCP Ping),视为Ping已到达 |
| do_nslookup | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行nslookup监测 |
| do_tracert | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行traceroute监测 |
| do_scrshot | Int | 否 | 0:不开启,1:当出现页面错误时执行,2:当出现页面错误或内容错误时执行,3:总是执行,默认:0 | 执行页面截屏 |
| do_src | Int | 否 | 0:不开启,1:页面错误时上传源代码,2:页面错误和内容错误时上传源代码,3:总是上传源代码,默认:0 | 上传HTML源代码 |
| do_head | Int | 否 | 0:不开启,1:仅保留主元素和错误元素的头信息,2:保留所有元素响应头信息,3:保留所有元素请求头和响应头信息,默认:0 | 保留HTTP头 |
| do_pcap | Int | 否 | 0:不开启,1:当出现页面错误时执行,2:当出现页面错误或内容错误时执行,3:总是执行,默认:0 | 是否抓包 |
| check_dns | Int | 否 | 0:不检查,1:检查,默认:1 | 是否检查dns服务器设置 |
| support_ipv6 | Int | 否 | 0:IPV4/IPV6混合节点,1:只选IPV6节点,2:只选IPV4节点,默认:2 | 指定支持ipv6的节点 |
| dns_match | Int | 否 | 0:自动,1:与节点协议一致,默认:0 | DNS协议 |
| lan_task | Int | 否 | 0:否,1:是,默认:0 | 是否为内网监测 |
| if_bandwidth | Int | 否 | 0:不启用,1:启用,默认:0 | 是否开启带宽选项 |
| bandwidth_min | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最小值 |
| bandwidth_max | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最大值 |
| ignoreHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 排除监测节点(按ID) |
| ignoreProbeStr | String | 否 | 填写多个ip请以换行符\n间隔 | 排除监测节点(按IP) |
| containsHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 包含监测节点(按ID) |
| containsProbeIpStr | String | 否 | 填写多个ip请以换行符\n间隔 | 包含监测节点(按IP) |
| os_bs_filter_mode | Int | 否 | 0:排除,1:包含,默认:1 | 按操作系统/浏览器筛选监测节点 |
| osBsFilterStr | String | 否 | W5.1.1:Windows XP W5.2.2:Windows 2003 W6.0.1:Windows 2008 W6.1.1:Windows 7 W6.2.1:Windows 8 W6.1.99:Windows 2012 W6.1.2:Windows 2008 R2 W10.0.1:Windows 10 I:所有,I6:IE6,I7:IE7,I8:IE8,I9:IE9,I10:IE10,I11:IE11 C:所有,C55:Chrome 55,C79:Chrome 79 举例:排除Windows XP的IE6就填写W5.1.1;I6 | 按操作系统/浏览器筛选监测节点 |
| req_plugin_opt | String | 否 | V:Flash Player D:Flash Audio Player M:Windows Media Player R:Real player Q:QuickTime(Alpha Testing) L:SilverLight | 仅选取安装了指定客户端插件的监测节点 |
| scatter | Int | 否 | 0:不启用,1:启用,默认:1 | 分散监测 |
| logon_user | Int | 否 | 0:否,1:是,默认:0 | 使用LocalStorage |
| disable_dnsclient | Int | 否 | 0:不禁用,1:禁用,默认:1 | 禁用监测节点的DNS Client服务(DNS缓存) |
| log_ssl_info | String | 否 | 1:是,0:否,当前只支持谷歌浏览器 | 是否开启证书监控 |
| end_to_end | Int | 否 | 0 不启用,1 启用,默认0 | 是否开启听云端到端服务 |
| first_main | Int | 否 | 0:否,1:是,默认:0 | 首元素为主元素 |
| host_dispatch_method | Int | 否 | 0:轮询,1:随机,默认:0 | 自定义hosts(IP-域名映射表) |
| hosts | String | 否 | 自定义hosts,支持多个,批量创建任务时,无','间隔时,所有任务公用一份hosts配置,多个','间隔时,必须与任务名称的数量一致,否则视为非法的数据 多个host以换行符进行间隔 | 自定义hosts配置 |
| enable_quic | Int | 否 | 0:否,1:是,默认:0(提示:浏览器内核请勾选Chrome) | 是否指定quic |
| quic_version | Int | 否 | 0:自动,46:46,默认:0 | quic版本 |
| http_auth_user | String | 否 | -- | http认证用户名 |
| http_auth_pass | String | 否 | -- | http认证密码 |
| http_compression | Int | 否 | 0:不启用,1:启用,默认:1 | 启用HTTP压缩 |
| user_agent | Int | 否 | 0:否,1:是,默认:1 | 使用听云Network User-Agent |
| accept_lang | String | 否 | zh-CN:简体中文 zh-TW:繁体中文 en:英文 默认:zh-CN | 浏览器语言 |
| custom_head | String | 否 | 自定义Http头,支持多个,批量创建任务时,无','间隔时,所有任务公用一份自定义Http头配置,多个','间隔时,必须与任务名称的数量一致,否则视为非法的数据 多个自定义Http头以换行符进行间隔 | 自定义Http头 |
| check_hijacking | Int | 否 | 0:不开启,1:开启,默认:0 | 是否开启劫持检测 |
| hijack_host_white_list | String | 否 | -- | IP白名单(DNS劫持) |
| hijack_cname_level | Int | 否 | 范围:0-100 | cname层级 |
| hijack_url_white_list | String | 否 | -- | 域名白名单(页面劫持) |
| post_parameter | String | 否 | 在请求方式为post时使用 | post请求参数 |
| header_text | String | 否 | -- | 预期Header信息 |
| reqed_text | String | 否 | -- | 预期正确文本 |
| Intelligent_dispatch | Int | 否 | 0:否,1:是,默认:0 | 是否智能降噪 |
| dispatch_by_city_isp | Int | 否 | 0:否,1:是,默认:0 | 当某城市运营商SLA不足时,调度到同省份的省会城市运营商执行(国外调度到同国家) |
| dispatch_by_error | Int | 否 | 0:否,1:是,默认:0 | 出现页面错误重发(重发一次) |
| dispatch_by_indicator | Int | 否 | 0:否,1:是,默认:0 | 性能指标超阈值重发(重发一次) |
| dispatch_indicator_field | String | 否 | T:总下载时间 D:DNS时间 C:建立连接时间 S:SSL握手时间 F:首包时间 O:内容下载时间 L:客户端时间 默认:T | 性能指标超阈值重发指标 |
| dispatch_indicator_threshold | double | 否 | -- | 性能指标超阈值 |
Ping监测
| 字段名 | 类型 | 必填 | 选项 | 描述 |
|---|---|---|---|---|
| authkey | String | 是 | -- | 授权码 |
| type | Int | 是 | 0:PING | 任务类型 |
| detail_id | Int | 是 | -- | 套餐id |
| name | String | 是 | 多个任务名称之间以','间隔,任务名称的个数必须与URL的个数相同 | 任务名称 |
| url | String | 是 | 多个任务URL之间以','间隔,URL的个数必须与任务名称的个数相同 | 任务URL |
| expire | Date | 是 | yyyy-MM-dd | 任务有效期 |
| probgrp_id | Int | 是 | -- | 节点组ID |
| Interval | Int | 是 | 60:1分钟 300:5分钟 600:10分钟 900:15分钟 1800:30分钟 3600:1小时 7200:2小时 10800:3小时 14400:4小时 21600:6小时 28800:8小时 43200:12小时 86400:24小时 | 监测频率 |
| if_bind | Int | 否 | 0:否,1:是 | 是否开启绑定任务(批量创建时使用) |
| ping_size | Int | 否 | 范围:0~65500 | ping包大小 |
| ping_count | Int | 否 | 范围:0~500 | ping次数 |
| ping_inv | Int | 否 | 范围:200~5000 | Ping间隔 |
| timeout | Int | 否 | 任务超时(10-60)秒,Ping次数*间隔时间不能大于超时时间 | 超时时间 |
| if_tcp_ping | Int | 否 | 0:否,1:是,默认:0 | 是否tcpping |
| rst_ok | Int | 否 | 0:否,1:是 | 当TCP连接被重置时(TCP Ping),视为Ping已到达 |
| ping_nofrag | Int | 否 | 0:否,1:是,默认:0 | 切包 |
| do_tracert | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行traceroute监测 |
| do_nslookup | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行nslookup监测 |
| check_dns | Int | 否 | 0:不检查,1:检查,默认:1 | 是否检查dns服务器设置 |
| support_ipv6 | Int | 否 | 0:IPV4/IPV6混合节点,1:只选IPV6节点,2:只选IPV4节点,默认:2 | 指定支持ipv6的节点 |
| dns_match | Int | 否 | 0:自动,1:与节点协议一致,默认:0 | DNS协议 |
| if_bandwidth | Int | 否 | 0:不启用,1:启用,默认:0 | 是否开启带宽选项 |
| bandwidth_min | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最小值 |
| bandwidth_max | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最大值 |
| lan_task | Int | 否 | 0:否,1:是,默认:0 | 是否为内网监测 |
| scatter | Int | 否 | 0:不启用,1:启用,默认:1 | 分散监测 |
| ignoreHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 排除监测节点(按ID) |
| ignoreProbeStr | String | 否 | 填写多个ip请以换行符\n间隔 | 排除监测节点(按IP) |
| containsHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 包含监测节点(按ID) |
| containsProbeIpStr | String | 否 | 填写多个ip请以换行符\n间隔 | 包含监测节点(按IP) |
| Intelligent_dispatch | Int | 否 | 0:否,1:是,默认:0 | 是否智能降噪 |
| dispatch_by_city_isp | Int | 否 | 0:否,1:是,默认:0 | 当某城市运营商SLA不足时,调度到同省份的省会城市运营商执行(国外调度到同国家) |
| dispatch_by_error | Int | 否 | 0:否,1:是,默认:0 | 出现页面错误重发(重发一次) |
| dispatch_by_indicator | Int | 否 | 0:否,1:是,默认:0 | 性能指标超阈值重发(重发一次) |
| dispatch_indicator_field | String | 否 | PA:延时 PPL:丢包率 默认:PA | 性能指标超阈值重发指标 |
| dispatch_indicator_threshold | double | 否 | -- | 性能指标超阈值 |
事务监测
| 字段名 | 类型 | 必填 | 选项 | 描述 |
|---|---|---|---|---|
| authkey | String | 是 | -- | 授权码 |
| type | Int | 是 | 2:PC事务类型 | 任务类型 |
| detail_id | Int | 是 | -- | 套餐id |
| name | String | 是 | 多个任务名称之间以','间隔,任务名称的个数必须与URL的个数相同 | 任务名称 |
| script_id | Int | 是 | 需要先调用事务脚本上传接口获取script_id | 脚本ID |
| expire | Date | 是 | yyyy-MM-dd | 任务有效期 |
| probgrp_id | Int | 是 | -- | 节点组ID |
| Interval | Int | 是 | 60:1分钟 300:5分钟 600:10分钟 900:15分钟 1800:30分钟 3600:1小时 7200:2小时 10800:3小时 14400:4小时 21600:6小时 28800:8小时 43200:12小时 86400:24小时 | 监测频率 |
| bs_type | String | 否 | I:IE C:Chrome F:Firefox | 浏览器内核 |
| timeout | Int | 否 | 范围:1~300,默认:120 | 超时时间 |
| ext_wait | Int | 否 | 范围:0~5,默认:0 | 额外等待时间 |
| do_ping | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行ping监测 |
| ping_size | Int | 否 | 范围:0~65500 | ping包大小 |
| ping_count | Int | 否 | 范围:0~50 | ping次数 |
| if_tcp_ping | Int | 否 | 0:否,1:是,默认:0 | 是否tcpping |
| rst_ok | Int | 否 | 0:否,1:是 | 当TCP连接被重置时(TCP Ping),视为Ping已到达 |
| do_nslookup | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行nslookup监测 |
| do_tracert | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行traceroute监测 |
| do_scrshot | Int | 否 | 0:不开启,1:当出现页面错误时执行,2:当出现页面错误或内容错误时执行,3:总是执行,默认:0 | 执行页面截屏 |
| do_src | Int | 否 | 0:不开启,1:页面错误时上传源代码,2:页面错误和内容错误时上传源代码,3:总是上传源代码,默认:0 | 上传HTML源代码 |
| do_head | Int | 否 | 0:不开启,1:仅保留主元素和错误元素的头信息,2:保留所有元素响应头信息,3:保留所有元素请求头和响应头信息,默认:0 | 保留HTTP头 |
| do_pcap | Int | 否 | 0:不开启,1:当出现页面错误时执行,2:当出现页面错误或内容错误时执行,3:总是执行,默认:0 | 是否抓包 |
| check_dns | Int | 否 | 0:不检查,1:检查,默认:1 | 是否检查dns服务器设置 |
| support_ipv6 | Int | 否 | 0:IPV4/IPV6混合节点,1:只选IPV6节点,2:只选IPV4节点,默认:2 | 指定支持ipv6的节点 |
| dns_match | Int | 否 | 0:自动,1:与节点协议一致,默认:0 | DNS协议 |
| lan_task | Int | 否 | 0:否,1:是,默认:0 | 是否为内网监测 |
| if_bandwidth | Int | 否 | 0:不启用,1:启用,默认:0 | 是否开启带宽选项 |
| bandwidth_min | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最小值 |
| bandwidth_max | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最大值 |
| ignoreHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 排除监测节点(按ID) |
| ignoreProbeStr | String | 否 | 填写多个ip请以换行符\n间隔 | 排除监测节点(按IP) |
| containsHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 包含监测节点(按ID) |
| containsProbeIpStr | String | 否 | 填写多个ip请以换行符\n间隔 | 包含监测节点(按IP) |
| os_bs_filter_mode | Int | 否 | 0:排除,1:包含,默认:1 | 按操作系统/浏览器筛选监测节点 |
| osBsFilterStr | String | 否 | W5.1.1:Windows XP W5.2.2:Windows 2003 W6.0.1:Windows 2008 W6.1.1:Windows 7 W6.2.1:Windows 8 W6.1.99:Windows 2012 W6.1.2:Windows 2008 R2 W10.0.1:Windows 10 I:所有,I6:IE6,I7:IE7,I8:IE8,I9:IE9,I10:IE10,I11:IE11 C:所有,C55:Chrome 55,C79:Chrome 79 举例:排除Windows XP的IE6就填写W5.1.1;I6 | 按操作系统/浏览器筛选监测节点 |
| req_plugin_opt | String | 否 | V:Flash Player D:Flash Audio Player M:Windows Media Player R:Real player Q:QuickTime(Alpha Testing) L:SilverLight | 仅选取安装了指定客户端插件的监测节点 |
| scatter | Int | 否 | 0:不启用,1:启用,默认:1 | 分散监测 |
| logon_user | Int | 否 | 0:否,1:是,默认:0 | 使用LocalStorage |
| disable_dnsclient | Int | 否 | 0:不禁用,1:禁用,默认:1 | 禁用监测节点的DNS Client服务(DNS缓存) |
| log_ssl_info | String | 否 | 1:是,0:否,当前只支持谷歌浏览器 | 是否开启证书监控 |
| end_to_end | Int | 否 | 0 不启用,1 启用,默认0 | 是否开启听云端到端服务 |
| first_main | Int | 否 | 0:否,1:是,默认:0 | 首元素为主元素 |
| script_enable | Int | 否 | 0:不启用,1:启用,默认:1 | 允许客户端运行脚本 |
| popup_window | Int | 否 | 0:不启用,1:启用,默认:1 | 允许弹出窗口 |
| tstotal_calc_way | Int | 否 | 0:否,1:是,默认:0 | 忽略客户端时间 |
| scrfirst_width | Int | 否 | -- | 首屏尺寸(宽) |
| scrfirst_length | Int | 否 | -- | 首屏尺寸(高) |
| first_screen_Interval | Int | 否 | 100:100ms,150:150ms,200:200ms,250:250ms,300:300ms,400:400ms,500:500ms,0:默认 | 首屏监测时间间隔 |
| host_dispatch_method | Int | 否 | 0:轮询,1:随机,默认:0 | 自定义hosts(IP-域名映射表) |
| hosts | String | 否 | 自定义hosts,支持多个,批量创建任务时,无','间隔时,所有任务公用一份hosts配置,多个','间隔时,必须与任务名称的数量一致,否则视为非法的数据 多个host以换行符进行间隔 | 自定义hosts配置 |
| enable_quic | Int | 否 | 0:否,1:是,默认:0(提示:浏览器内核请勾选Chrome) | 是否指定quic |
| quic_version | Int | 否 | 0:自动,46:46,默认:0 | quic版本 |
| quic_hosts | String | 否 | -- | quic域名列表 |
| http_auth_user | String | 否 | -- | http认证用户名 |
| http_auth_pass | String | 否 | -- | http认证密码 |
| http_compression | Int | 否 | 0:不启用,1:启用,默认:1 | 启用HTTP压缩 |
| user_agent | Int | 否 | 0:否,1:是,默认:1 | 使用听云Network User-Agent |
| accept_lang | String | 否 | zh-CN:简体中文 zh-TW:繁体中文 en:英文 默认:zh-CN | 浏览器语言 |
| custom_head | String | 否 | 自定义Http头,支持多个,批量创建任务时,无','间隔时,所有任务公用一份自定义Http头配置,多个','间隔时,必须与任务名称的数量一致,否则视为非法的数据 多个自定义Http头以换行符进行间隔 | 自定义Http头 |
| block_urls | String | 否 | -- | 监测时排除以下元素url |
| accept_urls | String | 否 | -- | 监测时仅访问以下元素url |
| elem_regex | String | 否 | -- | 元素URL合并规则 |
| check_hijacking | Int | 否 | 0:不开启,1:开启,默认:0 | 是否开启劫持检测 |
| hijack_host_white_list | String | 否 | -- | IP白名单(DNS劫持) |
| hijack_cname_level | Int | 否 | 范围:0-100 | cname层级 |
| hijack_url_white_list | String | 否 | -- | 域名白名单(页面劫持) |
流媒体监测
| 字段名 | 类型 | 必填 | 选项 | 描述 |
|---|---|---|---|---|
| authkey | String | 是 | -- | 授权码 |
| type | Int | 是 | 3:PC流媒体 | 任务类型 |
| task_option | String | 否 | V:Flash HTTP Video (.flv/.mp4) H:Flash RTMP Video (rtmp://) M:MediaPlayer Video (.wmv/.asf) A:MediaPlayer Audio/M4A (.wma/ .m4a) D:MP3 Audio /m3u8(.mp3/.m3u8) VLC:VLC HTTP Video Audio(.flv/.MP4/.MP3/.m3u8) 默认:VLC | 流媒体类型 |
| detail_id | Int | 是 | -- | 套餐id |
| name | String | 是 | 多个任务名称之间以','间隔,任务名称的个数必须与URL的个数相同 | 任务名称 |
| url_type | Int | 否 | 0:流媒体文件,1:流媒体页面,默认:0 | 流媒体url类型 |
| url | String | 是 | 多个任务URL之间以','间隔,URL的个数必须与任务名称的个数相同 | 任务URL |
| clear_type | Int | 否 | 0:标清,1:高清,2:超清,3:720P,4:1080P,5:2K,6:4K | 视频清晰度 |
| reqed_text | String | 否 | -- | 特征码匹配 |
| stream_length | Int | 否 | 0:否,1:是 | 字节数匹配 |
| do_uvmos | Int | 否 | 0:否,1:是,默认:0 | 是否抓取uvmos数据 |
| expire | Date | 是 | yyyy-MM-dd | 任务有效期 |
| probgrp_id | Int | 是 | -- | 节点组ID |
| Interval | Int | 是 | 60:1分钟 300:5分钟 600:10分钟 900:15分钟 1800:30分钟 3600:1小时 7200:2小时 10800:3小时 14400:4小时 21600:6小时 28800:8小时 43200:12小时 86400:24小时 | 监测频率 |
| if_bind | Int | 否 | 0:否,1:是 | 是否开启绑定任务(批量创建时使用) |
| timeout | Int | 否 | 范围:1~300,默认:60 | 监测时长 |
| page_timeout | Int | 否 | 范围:1~300,默认:60 | 流媒体页面加载超时时间 |
| popup_window | Int | 否 | 0:点播或直播,1:直播,2:点播,3:DVR | 播放方式 |
| elemerr_to_page | Int | 否 | 0:否,1:是 | 元素错误是否影响可用性选项 |
| ext_wait | Int | 否 | 范围:0~10,默认:3 | 首次播放前缓冲区中至少缓冲时间 |
| elem_regex | String | 否 | -- | 播放器特征码 |
| err_text | String | 否 | -- | 使用定制网络流媒体播放器 |
| do_ping | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行ping监测 |
| ping_size | Int | 否 | 范围:0~65500 | ping包大小 |
| ping_count | Int | 否 | 范围:0~50 | ping次数 |
| if_tcp_ping | Int | 否 | 0:否,1:是,默认:0 | 是否tcpping |
| rst_ok | Int | 否 | 0:否,1:是 | 当TCP连接被重置时(TCP Ping),视为Ping已到达 |
| do_nslookup | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行nslookup监测 |
| do_tracert | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行traceroute监测 |
| do_scrshot | Int | 否 | 0:不开启,1:当出现页面错误时执行,2:当出现页面错误或内容错误时执行,3:总是执行,默认:0 | 执行页面截屏 |
| do_src | Int | 否 | 0:不开启,1:页面错误时上传源代码,2:页面错误和内容错误时上传源代码,3:总是上传源代码,默认:0 | 上传HTML源代码 |
| do_head | Int | 否 | 0:不开启,1:仅保留主元素和错误元素的头信息,2:保留所有元素响应头信息,3:保留所有元素请求头和响应头信息,默认:0 | 保留HTTP头 |
| do_pcap | Int | 否 | 0:不开启,1:当出现页面错误时执行,2:当出现页面错误或内容错误时执行,3:总是执行,默认:0 | 是否抓包 |
| check_dns | Int | 否 | 0:不检查,1:检查,默认:1 | 是否检查dns服务器设置 |
| support_ipv6 | Int | 否 | 0:IPV4/IPV6混合节点,1:只选IPV6节点,2:只选IPV4节点,默认:2 | 指定支持ipv6的节点 |
| dns_match | Int | 否 | 0:自动,1:与节点协议一致,默认:0 | DNS协议 |
| lan_task | Int | 否 | 0:否,1:是,默认:0 | 是否为内网监测 |
| end_to_end | Int | 否 | 0 不启用,1 启用,默认0 | 是否开启听云端到端服务 |
| ignoreHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 排除监测节点(按ID) |
| ignoreProbeStr | String | 否 | 填写多个ip请以换行符\n间隔 | 排除监测节点(按IP) |
| containsHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 包含监测节点(按ID) |
| containsProbeIpStr | String | 否 | 填写多个ip请以换行符\n间隔 | 包含监测节点(按IP) |
| os_bs_filter_mode | Int | 否 | 0:排除,1:包含,默认:1 | 按操作系统/浏览器筛选监测节点 |
| osBsFilterStr | String | 否 | W5.1.1:Windows XP W5.2.2:Windows 2003 W6.0.1:Windows 2008 W6.1.1:Windows 7 W6.2.1:Windows 8 W6.1.99:Windows 2012 W6.1.2:Windows 2008 R2 W10.0.1:Windows 10 I:所有,I6:IE6,I7:IE7,I8:IE8,I9:IE9,I10:IE10,I11:IE11 举例:排除Windows XP的IE6就填写W5.1.1;I6 | 按操作系统/浏览器筛选监测节点 |
| ign_plugin_opt | String | 否 | V:HTTP FLV D:FLASH AUDIO M:MEDIAPLAYER VIDEO R:REAL VIDEO L:SilverLight Q:QUICKTIME | 排除安装了指定客户端插件的监测节点 |
| scatter | Int | 否 | 0:不启用,1:启用,默认:1 | 分散监测 |
| disable_dnsclient | Int | 否 | 0:不禁用,1:禁用,默认:1 | 禁用监测节点的DNS Client服务(DNS缓存) |
| first_main | Int | 否 | 0:否,1:是,默认:0 | 首元素为主元素 |
| host_dispatch_method | Int | 否 | 0:轮询,1:随机,默认:0 | 自定义hosts(IP-域名映射表) |
| hosts | String | 否 | 自定义hosts,支持多个,批量创建任务时,无','间隔时,所有任务公用一份hosts配置,多个','间隔时,必须与任务名称的数量一致,否则视为非法的数据 多个host以换行符进行间隔 | 自定义hosts配置 |
| http_auth_user | String | 否 | -- | http认证用户名 |
| http_auth_pass | String | 否 | -- | http认证密码 |
| http_compression | Int | 否 | 0:不启用,1:启用,默认:1 | 启用HTTP压缩 |
| user_agent | Int | 否 | 0:否,1:是,默认:1 | 使用听云Network User-Agent |
| custom_head | String | 否 | 自定义Http头,支持多个,批量创建任务时,无','间隔时,所有任务公用一份自定义Http头配置,多个','间隔时,必须与任务名称的数量一致,否则视为非法的数据 多个自定义Http头以换行符进行间隔 | 自定义Http头 |
| check_hijacking | Int | 否 | 0:不开启,1:开启,默认:0 | 是否开启劫持检测 |
| hijack_host_white_list | String | 否 | -- | IP白名单(DNS劫持) |
| hijack_cname_level | Int | 否 | 范围:0-100 | cname层级 |
| hijack_url_white_list | String | 否 | -- | 域名白名单(页面劫持) |
| Intelligent_dispatch | Int | 否 | 0:否,1:是,默认:0 | 是否智能降噪 |
| dispatch_by_city_isp | Int | 否 | 0:否,1:是,默认:0 | 当某城市运营商SLA不足时,调度到同省份的省会城市运营商执行(国外调度到同国家) |
| dispatch_by_error | Int | 否 | 0:否,1:是,默认:0 | 出现页面错误重发(重发一次) |
| dispatch_by_indicator | Int | 否 | 0:否,1:是,默认:0 | 性能指标超阈值重发(重发一次) |
| dispatch_indicator_field | String | 否 | CSS:缓冲前准备时间 BF:缓冲时间 RB:再缓冲时间 默认:CSS | 性能指标超阈值重发指标 |
| dispatch_indicator_threshold | double | 否 | -- | 性能指标超阈值 |
MTR监测
| 字段名 | 类型 | 必填 | 选项 | 描述 |
|---|---|---|---|---|
| authkey | String | 是 | -- | 授权码 |
| type | Int | 是 | 11:MTR | 任务类型 |
| detail_id | Int | 是 | -- | 套餐id |
| name | String | 是 | 多个任务名称之间以','间隔,任务名称的个数必须与URL的个数相同 | 任务名称 |
| url | String | 是 | 多个任务URL之间以','间隔,URL的个数必须与任务名称的个数相同 | 任务URL |
| expire | Date | 是 | yyyy-MM-dd | 任务有效期 |
| probgrp_id | Int | 是 | -- | 节点组ID |
| Interval | Int | 是 | 60:1分钟 300:5分钟 600:10分钟 900:15分钟 1800:30分钟 3600:1小时 7200:2小时 10800:3小时 14400:4小时 21600:6小时 28800:8小时 43200:12小时 86400:24小时 | 监测频率 |
| ping_wait_time_again | Int | 否 | 范围:60~180 | 两次ping之间的等待时间 |
| hop_query_number | Int | 否 | 范围:1~150 | 每个跳跃点查询数 |
| do_tracert | Int | 否 | 范围:11~63 | 最大跳跃点数 |
| do_nslookup | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行nslookup监测 |
| check_dns | Int | 否 | 0:不检查,1:检查,默认:1 | 是否检查dns服务器设置 |
| support_ipv6 | Int | 否 | 0:IPV4/IPV6混合节点,1:只选IPV6节点,2:只选IPV4节点,默认:2 | 指定支持ipv6的节点 |
| dns_match | Int | 否 | 0:自动,1:与节点协议一致,默认:0 | DNS协议 |
| if_bandwidth | Int | 否 | 0:不启用,1:启用,默认:0 | 是否开启带宽选项 |
| bandwidth_min | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最小值 |
| bandwidth_max | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最大值 |
| lan_task | Int | 否 | 0:否,1:是,默认:0 | 是否为内网监测 |
| scatter | Int | 否 | 0:不启用,1:启用,默认:1 | 分散监测 |
| ignoreHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 排除监测节点(按ID) |
| ignoreProbeStr | String | 否 | 填写多个ip请以换行符\n间隔 | 排除监测节点(按IP) |
| containsHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 包含监测节点(按ID) |
| containsProbeIpStr | String | 否 | 填写多个ip请以换行符\n间隔 | 包含监测节点(按IP) |
| Intelligent_dispatch | Int | 否 | 0:否,1:是,默认:0 | 是否智能降噪 |
| dispatch_by_city_isp | Int | 否 | 0:否,1:是,默认:0 | 当某城市运营商SLA不足时,调度到同省份的省会城市运营商执行(国外调度到同国家) |
| dispatch_by_error | Int | 否 | 0:否,1:是,默认:0 | 出现页面错误重发(重发一次) |
| dispatch_by_indicator | Int | 否 | 0:否,1:是,默认:0 | 性能指标超阈值重发(重发一次) |
| dispatch_indicator_field | String | 否 | MPA:平均延时 MPL:丢包率 MPJ:抖动 默认:MPA | 性能指标超阈值重发指标 |
| dispatch_indicator_threshold | double | 否 | -- | 性能指标超阈值 |
TraceRoute
| 字段名 | 类型 | 必填 | 选项 | 描述 |
|---|---|---|---|---|
| authkey | String | 是 | -- | 授权码 |
| type | Int | 是 | 10:TraceRoute | 任务类型 |
| detail_id | Int | 是 | -- | 套餐id |
| name | String | 是 | 多个任务名称之间以','间隔,任务名称的个数必须与URL的个数相同 | 任务名称 |
| url | String | 是 | 多个任务URL之间以','间隔,URL的个数必须与任务名称的个数相同 | 任务URL |
| expire | Date | 是 | yyyy-MM-dd | 任务有效期 |
| probgrp_id | Int | 是 | -- | 节点组ID |
| Interval | Int | 是 | 60:1分钟 300:5分钟 600:10分钟 900:15分钟 1800:30分钟 3600:1小时 7200:2小时 10800:3小时 14400:4小时 21600:6小时 28800:8小时 43200:12小时 86400:24小时 | 监测频率 |
| if_bind | Int | 否 | 0:否,1:是 | 是否开启绑定任务(批量创建时使用) |
| ping_size | Int | 否 | 范围:0~50 | TraceRoute包大小 |
| ping_count | Int | 否 | 范围:0~20 | 重试次数 |
| do_nslookup | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行nslookup监测 |
| check_dns | Int | 否 | 0:不检查,1:检查,默认:1 | 是否检查dns服务器设置 |
| support_ipv6 | Int | 否 | 0:IPV4/IPV6混合节点,1:只选IPV6节点,2:只选IPV4节点,默认:2 | 指定支持ipv6的节点 |
| dns_match | Int | 否 | 0:自动,1:与节点协议一致,默认:0 | DNS协议 |
| if_bandwidth | Int | 否 | 0:不启用,1:启用,默认:0 | 是否开启带宽选项 |
| bandwidth_min | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最小值 |
| bandwidth_max | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最大值 |
| lan_task | Int | 否 | 0:否,1:是,默认:0 | 是否为内网监测 |
| scatter | Int | 否 | 0:不启用,1:启用,默认:1 | 分散监测 |
| ignoreHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 排除监测节点(按ID) |
| ignoreProbeStr | String | 否 | 填写多个ip请以换行符\n间隔 | 排除监测节点(按IP) |
| containsHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 包含监测节点(按ID) |
| containsProbeIpStr | String | 否 | 填写多个ip请以换行符\n间隔 | 包含监测节点(按IP) |
私有协议监测
| 字段名 | 类型 | 必填 | 选项 | 描述 |
|---|---|---|---|---|
| authkey | String | 是 | -- | 授权码 |
| type | Int | 是 | 255:私有协议 | 任务类型 |
| task_option | String | 是 | 见具体协议,如TELNET | 私有协议option |
| timeout | Int | 否 | -- | 超时时间 |
| do_ping | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行ping监测 |
| do_tracert | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行traceroute监测 |
| if_tcp_ping | Int | 是 | 0:否,1:是,默认:0 | 是否tcpping |
| rst_ok | Int | 否 | 0:否,1:是 | 当TCP连接被重置时(TCP Ping),视为Ping已到达 |
| Intelligent_dispatch | Int | 否 | 0:否,1:是,默认:0 | 是否智能降噪 |
| dispatch_by_city_isp | Int | 否 | 0:否,1:是,默认:0 | 当某城市运营商SLA不足时,调度到同省份的省会城市运营商执行(国外调度到同国家) |
| dispatch_by_error | Int | 否 | 0:否,1:是,默认:0 | 出现页面错误重发(重发一次) |
| dispatch_by_indicator | Int | 否 | 0:否,1:是,默认:0 | 性能指标超阈值重发(重发一次) |
| dispatch_indicator_field | String | 否 | T:总下载时间 D:DNS时间 C:建立连接时间 S:SSL握手时间 F:首包时间 O:内容下载时间 L:客户端时间 默认:T | 性能指标超阈值重发指标 |
| dispatch_indicator_threshold | double | 否 | -- | 性能指标超阈值 |
| detail_id | Int | 是 | -- | 套餐id |
| name | String | 是 | 任务名称,在根据csv文件批量添加时将取csv内的name字段覆盖 | 任务名称 |
| url | String | 是 | 私有协议对应文件名,参照提交时的url字段 | 任务URL |
| expire | Date | 是 | yyyy-MM-dd | 任务有效期 |
| probgrp_id | Int | 是 | -- | 节点组ID |
| Interval | Int | 是 | 60:1分钟 300:5分钟 600:10分钟 900:15分钟 1800:30分钟 3600:1小时 7200:2小时 10800:3小时 14400:4小时 21600:6小时 28800:8小时 43200:12小时 86400:24小时 | 监测频率 |
| custom_head | String | 是 | -- | 私有协议参数选项 |
| customHeadFile | file | 否 | -- | 批量添加时使用的csv文件,第一列为任务名称name,第二列起为私有协议参数选项内要覆盖的字段名 |
| if_bind | Int | 否 | 0:否,1:是 | 是否开启绑定任务(批量创建时使用) |
| ping_size | Int | 否 | 范围:0~50 | ping包大小 |
| ping_count | Int | 否 | 范围:0~20 | 重试次数 |
| do_nslookup | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行nslookup监测 |
| check_dns | Int | 否 | 0:不检查,1:检查,默认:1 | 是否检查dns服务器设置 |
| if_bandwidth | Int | 否 | 0:不启用,1:启用,默认:0 | 是否开启带宽选项 |
| bandwidth_min | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最小值 |
| bandwidth_max | Int | 否 | 0(不限制),2,5,10,20,30,50,100 | 带宽选项最大值 |
| lan_task | Int | 否 | 0:否,1:是,默认:0 | 是否为内网监测 |
| scatter | Int | 否 | 0:不启用,1:启用,默认:1 | 分散监测 |
| ignoreHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 排除监测节点(按ID) |
| ignoreProbeStr | String | 否 | 填写多个ip请以换行符\n间隔 | 排除监测节点(按IP) |
| containsHostIdStr | String | 否 | 填写多个id请以换行符\n间隔 | 包含监测节点(按ID) |
| containsProbeIpStr | String | 否 | 填写多个ip请以换行符\n间隔 | 包含监测节点(按IP) |
移动
页面/文件/事务监测
| 字段名 | 类型 | 必填 | 选项 | 描述 |
|---|---|---|---|---|
| authkey | String | 是 | -- | 授权码 |
| type | Int | 是 | 101:手机文件下载 102:手机页面 103:手机事务类型 |
任务类型 |
| detail_id | Int | 是 | -- | 套餐ID |
| name | String | 是 | 多个任务名称之间以','间隔,任务名称的个数必须与URL的个数相同 | 任务名称 |
| script_id | Int | 是 | 需要先调用事务脚本上传接口获取script_id | 脚本ID(仅事务监测任务支持该参数) |
| url | String | 是 | 多个任务URL之间以','间隔,URL的个数必须与任务名称的个数相同 | 任务URL |
| probgrp_id | Int | 是 | -- | 节点组ID |
| expire | Date | 是 | yyyy-MM-dd | 任务有效期 |
| Interval | Int | 是 | 60:1分钟 300:5分钟 600:10分钟 900:15分钟 1800:30分钟 3600:1小时 7200:2小时 10800:3小时 14400:4小时 21600:6小时 28800:8小时 43200:12小时 86400:24小时 | 监测频率 |
| scatter | Int | 否 | 0:不启用,1:启用,默认:1 | 分散监测 |
| support_ipv6 | Int | 否 | 0:IPV4/IPV6混合节点,1:只选IPV6节点,2:只选IPV4节点,默认:2 | 指定支持ipv6的节点 |
| fun_plugin_opt | String | 否 | HTTPS:包含 | 是否包含https内容 |
| first_main | Int | 否 | 0:否,1:是,默认:0 | 首元素为主元素 |
| tstotal_calc_way | Int | 否 | 0:否,1:是,默认:0 | 忽略客户端时间 |
| timeout | Int | 否 | 范围:1~300,默认:60 | 超时时间 |
| ext_wait | Int | 否 | 范围:0~5,默认:0 | 额外等待时间 |
| do_ping | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行ping监测 |
| ping_size | Int | 否 | 范围:0~65500 | ping包大小 |
| ping_count | Int | 否 | 范围:0~50 | ping次数 |
| ping_inv | Int | 否 | 范围:200~5000 | Ping间隔 |
| do_tracert | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行traceroute监测 |
| do_nslookup | Int | 否 | 0:不开启,1:当出现页面错误时执行,3:总是执行,默认:0 | 执行nslookup监测 |
| do_scrshot | Int | 否 | 0:不开启,1:当出现页面错误时执行,2:当出现页面错误或内容错误时执行,3:总是执行,默认:0 | 执行页面截屏 |
| do_src | Int | 否 | 0:不开启,1:页面错误时上传源代码,2:页面错误和内容错误时上传源代码,3:总是上传源代码,默认:0 | 上传HTML源代码 |
| do_head | Int | 否 | 0:不开启,1:仅保留主元素和错误元素的头信息,2:保留所有元素响应头信息,3:保留所有元素请求头和响应头信息,默认:0 | 保留HTTP头 |
| reqed_text | String | 否 | -- | 预期正确文本 |
| err_text | String | 否 | -- | 错误文本 |
| host_dispatch_method | Int | 否 | 0:轮询,1:随机,默认:0 | 自定义hosts(IP-域名映射表) |
| hosts | String | 否 | 自定义hosts,支持多个,批量创建任务时,无','间隔时,所有任务公用一份hosts配置,多个','间隔时,必须与任务名称的数量一致,否则视为非法的数据 多个host以换行符进行间隔 | 自定义hosts配置 |
| block_urls | String | 否 | -- | 监测时排除以下元素url |
| accept_urls | String | 否 | -- | 监测时仅访问以下元素url |
| custom_head | String | 否 | 自定义Http头,支持多个,批量创建任务时,无','间隔时,所有任务公用一份自定义Http头配置,多个','间隔时,必须与任务名称的数量一致,否则视为非法的数据 多个自定义Http头以换行符进行间隔 | 自定义Http头 |
| elem_regex | String | 否 | -- | 元素URL合并规则 |
| check_hijacking | Int | 否 | 0:不开启,1:开启,默认:0 | 是否开启劫持检测 |
| hijack_host_white_list | String | 否 | -- | IP白名单(DNS劫持) |
| hijack_url_white_list | String | 否 | -- | 域名白名单(页面劫持) |
| osBsFilterStr | String | 否 | Android-3 Android-4 Android-4.3 Android-4.4 Android-5 Android-6 Android-7 Android-8 举例:排除Android-3填写Android-3; | 按操作系统/浏览器筛选监测节点 |
| Intelligent_dispatch | Int | 否 | 0:否,1:是,默认:0 | 是否智能降噪(事务监测任务不支持该参数) |
| dispatch_by_city_isp | Int | 否 | 0:否,1:是,默认:0 | 当某城市运营商SLA不足时,调度到同省份的省会城市运营商执行(国外调度到同国家)(事务监测任务不支持该参数) |
| dispatch_by_error | Int | 否 | 0:否,1:是,默认:0 | 出现页面错误重发(重发一次)(事务监测任务不支持该参数) |
| dispatch_by_indicator | Int | 否 | 0:否,1:是,默认:0 | 性能指标超阈值重发(重发一次)(事务监测任务不支持该参数) |
| dispatch_indicator_field | String | 否 | T:总下载时间 D:DNS时间 C:建立连接时间 S:SSL握手时间 F:首包时间 O:内容下载时间 L:客户端时间 U:首屏时间 默认:T | 性能指标超阈值重发指标(事务监测任务不支持该参数) |
| dispatch_indicator_threshold | double | 否 | -- | 性能指标超阈值(事务监测任务不支持该参数) |
Ping监测
| 字段名 | 类型 | 必填 | 选项 | 描述 |
|---|---|---|---|---|
| authkey | String | 是 | -- | 授权码 |
| type | Int | 是 | 100:手机PING | 任务类型 |
| detail_id | Int | 是 | -- | 套餐id |
| name | String | 是 | 多个任务名称之间以','间隔,任务名称的个数必须与URL的个数相同 | 任务名称 |
| url | String | 是 | 多个任务URL之间以','间隔,URL的个数必须与任务名称的个数相同 | 任务URL |
| probgrp_id | Int | 是 | -- | 节点组ID |
| expire | Date | 是 | yyyy-MM-dd | 任务有效期 |
| Interval | Int | 是 | 60:1分钟 300:5分钟 600:10分钟 900:15分钟 1800:30分钟 3600:1小时 7200:2小时 10800:3小时 14400:4小时 21600:6小时 28800:8小时 43200:12小时 86400:24小时 | 监测频率 |
| scatter | Int | 否 | 0:不启用,1:启用,默认:1 | 分散监测 |
| support_ipv6 | Int | 否 | 0:IPV4/IPV6混合节点,1:只选IPV6节点,2:只选IPV4节点,默认:2 | 指定支持IPv6的节点 |
| ping_size | Int | 否 | 范围:0~65500 | Ping包大小 |
| ping_count | Int | 否 | 范围:0~50 | Ping次数 |
| ping_inv | Int | 否 | 范围:200~5000 | Ping间隔 |
| if_tcp_ping | Int | 否 | 0:否,1:是,默认:0 | 是否TCP Ping |
| Intelligent_dispatch | Int | 否 | 0:否,1:是,默认:0 | 是否智能降噪 |
| dispatch_by_city_isp | Int | 否 | 0:否,1:是,默认:0 | 当某城市运营商SLA不足时,调度到同省份的省会城市运营商执行(国外调度到同国家) |
| dispatch_by_error | Int | 否 | 0:否,1:是,默认:0 | 出现页面错误重发(重发一次) |
| dispatch_by_indicator | Int | 否 | 0:否,1:是,默认:0 | 性能指标超阈值重发(重发一次) |
| dispatch_indicator_field | String | 否 | PA:延时 PPL:丢包率 默认:PA | 性能指标超阈值重发指标 |
| dispatch_indicator_threshold | double | 否 | -- | 性能指标超阈值 |
返回参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| data | Object | 任务保存成功后的任务编号 |
| message | String | 错误信息 |
| error_code | Int | 错误码 |
| request | String | 请求路径 |
| time | Date | 请求时间 |
错误说明
| 字段说明 | 错误信息 |
|---|---|
| dispatch_by_indicator | 当前监测类型不支持智能降噪选项 |
| user_agent | 使用 听云Network User-Agent数据的最大值域超过限制 |
| os_bs_filter_mode | 按操作系统/浏览器筛选监测节点包含,排除数据的最大值域超过限制 |
| do_uvmos | 是否抓取uvmos数据数据的最大值域超过限制 |
| do_scroll_page | 支持滚屏数据的最大值域超过限制 |
| do_pcap | 对不起,您为该任务设置的'抓包选项'超过了套餐约定的范围,请重新设置。 |
| lan_task | 是否为内网监测数据的最大值域超过限制 |
| check_hijacking | 开启劫持检测数据的最大值域超过限制 |
| support_ipv6 | 监测节点类型数据的最大值域超过限制 |
| ping_size | ping包大小数据的最大值域超过限制 |
| ping_inv | Ping间隔必须在200ms~5000ms范围内 |
| dispatch_by_city_isp | 当前监测类型不支持智能降噪选项 |
| bs_type | 浏览器内核配置的数据不在可选的范围内 |
| Intelligent_dispatch | 智能降噪选项数据的最大值域超过限制 |
| fun_plugin_opt | 客户端是否包含HTTPS包含的功能插件配置的数据不在可选的范围内 |
| do_src | 对不起,您为该任务设置的'上传HTML源代码'超过了套餐约定的范围,请重新设置。 |
| accept_lang | 浏览器语言配置的数据不在可选的范围内 |
| hijack_host_white_list | 该监测类型不支持劫持监测 |
| request_type | 请求方式数据的最大值域超过限制 |
| ext_wait | 额外等待时间数据的最大值域超过限制 |
| do_pcap | 是否开启抓包数据的最大值域超过限制 |
| status | 任务状态数据的最大值域超过限制 |
| enable_quic | 指定QUIC协议数据的最大值域超过限制 |
| do_scrshot | 对不起,您为该任务设置的'截屏选项'超过了套餐约定的范围,请重新设置。 |
| enable_quic | 指定QUIC协议,仅支持浏览器内核为Chrome |
| ping_nofrag | 切包数据的最大值域超过限制 |
| ignoreHostidStr | 排除监测节点(按ID)选项存在非法ID |
| dispatch_by_error | 出现页面错误重发(重发一次)数据的最大值域超过限制 |
| popup_window | 允许弹出窗口数据的最大值域超过限制 |
| first_main | 首元素为主元素数据的最大值域超过限制 |
| dispatch_by_error | 当前监测类型不支持智能降噪选项 |
| if_bandwidth | 设置节点带宽数据不合法 |
| do_head | 上传http头数据的最大值域超过限制 |
| dns_match | DNS协议数据的最大值域超过限制 |
| script_id | 请设置的脚本ID |
| if_tcp_ping | 当主机禁用ICMP时,尝试TCP方式执行Ping操作数据的最大值域超过限制 |
| check_dns | 是否检查dns服务器设置数据的最大值域超过限制 |
| ignoreProbeStr | 排除监测节点(按IP)选项存在非法IP |
| dispatch_by_city_isp | 当某城市运营商SLA不足时,调度到同省份的省会城市运营商执行(国外调度到同国家)数据的最大值域超过限制 |
| hijack_url_white_list | 该监测类型不支持劫持监测 |
| containsHostIdStr | 包含监测节点(按ID)选项存在非法ID |
| scatter | 是否分散监测点数据的最大值域超过限制 |
| verify_result_type | 结果验证类型数据的最大值域超过限制 |
| do_head | 对不起,您为该任务设置的'保留HTTP头'超过了套餐约定的范围,请重新设置。 |
| enable_quic | 该监测类型不支持指定QUIC协议 |
| tstotal_calc_way | 是否忽略客户端时间数据的最大值域超过限制 |
| quic_hosts | 由于设置了quicHosts,必须要启用QUIC协议 |
| quic_hosts | 该监测类型不支持指定QUIC协议,不允许指定quicHosts |
| do_nslookup | 对不起,您为该任务设置的'Nslookup选项'超过了套餐约定的范围,请重新设置。 |
| do_tracert | 对不起,您为该任务设置的'TraceRoute选项'超过了套餐约定的范围,请重新设置。 |
| dispatch_by_indicator | 性能指标超阈值重发(重发一次)数据的最大值域超过限制 |
| quic_version | 指定QUIC协议的版本号不合法 |
| elemerr_to_page | 元素错误是否影响可用性选项数据的最大值域超过限制 |
| do_tracert | Traceroute监测数据的最大值域超过限制 |
| ping_count | ping次数数据的最大值域超过限制 |
| timeout | 任务超时时间数据的最大值域超过限制 |
| hijack_url_white_list | 套餐未开启劫持监测 |
| first_screen_Interval | 首屏取样间隔(毫秒)数据的最大值域超过限制 |
| hijack_host_white_list | 套餐未开启劫持监测 |
| do_ping | 对不起,您为该任务设置的'Ping选项'超过了套餐约定的范围,请重新设置。 |
| if_bandwidth | 未开启带宽选项,不能设置节点带宽 |
| containsProbeIpStr | 包含监测节点(按IP)选项存在非法IP |
| http_compression | 启用HTTP压缩数据的最大值域超过限制 |
| disable_dnsclient | 禁用监测节点的DNS Client服务(DNS缓存)数据的最大值域超过限制 |
| dispatch_by_indicator | 智能降噪,开启性能指标超阈值重发,必须设置指标和对应的阈值 |
| do_scrshot | 页面截屏数据的最大值域超过限制 |
| url_type | URL或流媒体脚本选项数据的最大值域超过限制 |
| do_nslookup | nslookup监测数据的最大值域超过限制 |
| clear_type | 视频清晰度码率数据的最大值域超过限制 |
| logon_user | 使用LocalStorage数据的最大值域超过限制 |
| page_timeout | 页面超时时间数据的最大值域超过限制 |
| do_ping | Ping监测数据的最大值域超过限制 |
| do_src | 上传源代码数据的最大值域超过限制 |
| first_screen_Interval | 首屏取样间隔数据不合法 |
| if_bandwidth | 是否开启带宽选项数据的最大值域超过限制 |
| rst_ok | 当TCP连接被重置时(TCP Ping),视为Ping已到达数据的最大值域超过限制 |
| host_dispatch_method | 自定义hosts(IP-域名映射表)数据的最大值域超过限制 |
返回示例
{
"status": 200,
"data": [
70992
],
"message": "",
"error_code": 0,
"time": "2021-03-24 08:29:47"
}