接口规范说明
接口前提参数规则
开放api接口域名
接口响应状态码与错误码说明
基础信息描述
基础信息
获取访问开放api的token
地区基础信息
运营商基础信息
用户可以使用的监测点列表
获取任务正在使用的监测点信息
任务管理
基础信息
任务创建
任务修改
任务删除
任务详情
任务开启
任务暂停
任务列表
告警管理
创建任务的自定义告警规则
修改任务的自定义告警规则
删除任务的自定义告警规则
查看任务的自定义告警规则
创建任务告警通知
修改任务告警通知
获取任务告警通知
删除任务告警通知
历史快照数据
查看历史快照列表
查看单次历史快照详情
查看单次快照中的响应结果
任务故障
任务所有监测点的故障记录
任务单个监测点故障记录
任务单个监测点故障次数
告警消息
消息列表
响应时间与可用率
任务所有监测点的统计汇总数据
任务平均响应时间刻度数据
任务平均响应时间详细统计刻度数据
任务平均可用率刻度数据
traceroute任务跳数统计刻度数据
获取任务最近一次监测结果数据
监测点分组管理
账号监测点分组列表
获取监测点分组信息
修改监测点分组信息
添加监测点分组信息
删除监测点分组信息
用户管理
获取用户基本信息
修改用户基本信息
创建用户
删除用户
当前账户信息
获取当前账户信息
账号公共设置
获取当前账户下用户列表
获取当前账户套餐信息
用户分组管理
用户分组列表
添加用户分组
修改用户分组
删除用户分组
获取单个分组下的用户
获取多个分组下的用户
将用户添加入分组
附录
附录一 siteapi错误编码与含义
附录二 userapi错误编码与含义

<接口地址>:/siteapi/data/snapshot


<请求方式>:GET


<请求类型>:URL参数


<响应类型>:JSON


<请求参数>:

参数名称

是否必须

类型

默认值

描述

task_id

int

任务编号

start_time

date

开始时间

end_time

date

结束时间

monitor_id

int

监测点ID

resp_result

int

响应结果,0-失败,1-成功

page_size

int

10

每页条数

page

int

1

当前页码


<请求示例>:

/siteapi/data/snapshot?task_id=64&start_time=2018-01-01&end_time=2018-01-02&monitor_id=1


<响应数据>:

参数名称

数据类型

描述

pagination

json   object

分页信息

  total_records

int

记录总条数

  total_pages

int

总页数

  current_page

int

当前页码

  page_size

int

每页条数

monitor_info

array

监测点信息

 monitor_id

int

监测点ID

 monitor_name

string

监测点名称

 monitor_location

string

监测点所属地区

 monitor_ip

string

监测点IP

data

array

数据列表

  check_time

int

时间(unix时间戳)

  resp_result

string

响应结果

  resp_status

string

响应状态

  resp_time

float

响应时间

 resp_summary

array

当前监控概要,不同的监控类型概要内容不同,以下列举ping监控概要为例

http监控参数

 dns_time

float

DNS域名解析时间

 connect_time

float

建立连接时间

 appconnect_time

float

SSL握手时间,只适用于https任务

 process_time

float

服务器计算时间

 download_time

float

下载时间

 total_time

float

总计时间

 size_download

float

下载的字节数

 speed_download

float

下载的速度

Ping监控 resp_summary监控概要

target_ip

String

主机IP

bytes_per_request

int

数据包大小

bytes_total

int

总数据包大小

ttl

int

TTL值

raw_data

String

Ping快照(根据不同的监控任务返回不同的快照内容)

transmitted

int

发送的包数

received

int

收到的包数

loss

int

丢包率


<响应示例>:

{
    "pagination": {
     "total_records": 800,
     "total_pages": 40,
     "current_page": 18,
     "page_size": 20
     },
"monitor_info": {
"monitor_id": 1,
"monitor_name": "陕西西安电信",
"monitor_location": "陕西",
"monitor_ip": "123.23.23.23",
  },
"data": [
   {
          "check_time": "1463964437",
          "resp_result": "1", 
          "resp_status": "302 Moved Temporarily",
          "resp_time": "135.20",
          "dns_time": "0.63",
          "connect_time": "65.47",
          "process_time": "69.07",
          "download_time": "0.03",
          "total_time": "135.20",
          "size_download": "0.28",
          "speed_download": "2.11",
          "resp_summary": {
            "url":   "http://116.52.1.245/",
            "content_type": "text/html; charset=UTF-8",
            "http_code": 302,
            "header_size": 234,
            "request_size": 422,
            "filetime": -1,
            "ssl_verify_result": 0,
            "redirect_count": 0,
            "total_time": 135.197,
            "namelookup_time": 0.633,
            "connect_time": 66.1,
            "pretransfer_time": 66.102,
            "size_upload": 0,
            "size_download": 291,
            "speed_download": 2161,
            "speed_upload": 0,
            "download_content_length": -1,
            "upload_content_length": 0,
            "starttransfer_time": 135.171,
            "redirect_time": 0,
            "certinfo": [],
            "primary_ip": "116.52.1.245",
            "redirect_url":   "http://www.yngs.gov.cn/newW/template/index.jsp",
            "req_headers": [],
            "req_method": "GET",
            "req_httpv": "1.1",
            "ip":   "116.52.1.245",
            "resp_httpv": "1.1",
            "resp_headers": {
                      "Date": "Mon, 23 May 2016 00:40:23 GMT",
                      "Transfer-Encoding": "chunked",
                      "Location": "http://www.yngs.gov.cn//template/index.jsp",
                      "Content-Type": "text/html; charset=UTF-8",
                      "X-Powered-By": "*******************"
          },
            
      .............    //其他检测时间
            ]
}