任务修改

方法：POST

Content-Type：application/x-www-form-urlencoded

https://network.tingyun.com/network-report-data/task-config/edit-json-authkey

API依赖关系

  • id：需要请求任务列表接口获取任务ID。

  • probgrp_id：需要请求节点组列表接口获取对应的节点ID。

API调用流程图

  1. 调用任务列表API，获取关键参数id。
  2. 调用节点组列表API，获取关键参数probgrp_id。
  3. 调用任务修改API实现任务修改。

请求参数

固网

页面监测

字段名 类型 必填 选项 描述
authkey String 是 -- 授权码
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小时 监测频率
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 支持滚屏
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 是 -- 授权码
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小时 监测频率
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缓存）
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 是 -- 授权码
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_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 是 -- 授权码
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缓存）
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 是 -- 授权码
id Int 是 -- 任务id
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 流媒体类型
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小时 监测频率
timeout Int 否 范围:1~300,默认:60 监测时长
page_timeout Int 否 范围:1~300,默认:60 流媒体页面加载超时时间
popup_window Int 否 0:点播或直播,1:直播,2:点播,3:DVR 播放方式
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 是否为内网监测
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 是 -- 授权码
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 是 -- 授权码
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_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 是 -- 授权码
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_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 是 -- 授权码
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的节点
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_cname_level Int 否 范围：0-100 cname层级
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 否 -- 性能指标超阈值

文件监测

字段名 类型 必填 选项 描述
authkey String 是 -- 授权码
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的节点
fun_plugin_opt String 否 HTTPS:包含 是否包含https内容
first_main Int 否 0:否,1:是,默认:0 首元素为主元素
tstotal_calc_way Int 否 0:否,1:是,默认:0 忽略客户端时间
timeout Int 否 范围:1~300,默认:120 超时时间
request_type Int 否 0:GET,1:POST http请求方法
post_parameter String 否 在请求方式为post时使用 post请求参数
verify_result_type Int 否 -1:关闭,0:状态码验证,1:包含内容验证,2:内容正则表达式验证,3:内容md5验证 结果验证
reqed_text String 否 -- 预期正确文本
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_src Int 否 0:不开启,1:页面错误时上传源代码,2:页面错误和内容错误时上传源代码,3:总是上传源代码,默认:0 上传HTML源代码
do_head Int 否 0:不开启,1:仅保留主元素和错误元素的头信息,2:保留所有元素响应头信息,3:保留所有元素请求头和响应头信息,默认:0 保留HTTP头
host_dispatch_method Int 否 0:轮询,1:随机,默认:0 自定义hosts（IP-域名映射表）
hosts String 否 自定义hosts,支持多个,批量创建任务时，无','间隔时,所有任务公用一份hosts配置，多个','间隔时，必须与任务名称的数量一致，否则视为非法的数据 多个host以换行符进行间隔 自定义hosts配置
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 否 -- 域名白名单(页面劫持)
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:客户端时间 默认:T 性能指标超阈值重发指标
dispatch_indicator_threshold double 否 -- 性能指标超阈值

Ping监测

字段名 类型 必填 选项 描述
authkey String 是 -- 授权码
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 是否tcpping
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 是 -- 授权码
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小时 监测频率
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_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头
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_cname_level Int 否 范围：0-100 CName层级
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;		 按操作系统/浏览器筛选监测节点

返回参数

字段名 类型 描述
status Int 状态码
data Object 任务保存成功后的任务编号
message String 错误信息
error_code Int 错误码
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": [
        72886
    ],
    "message": "",
    "error_code": 0,
    "request": "",
    "time": "2021-04-15 08:56:31"
}
© 2007-2023 北京基调网络股份有限公司 all right reserved，powered by Gitbook本文档更新于： 2023-05-05 10:29

results matching ""

    No results matching ""