API概述
API访问认证
API访问认证过程
API客户端注册
获取访问Token
用AccessToken访问
API设计说明
用户管理
列出所有用户
查询单个用户
创建用户
修改用户
暂停用户
开启用户
用户分组信息
修改URL回调通知
网站监控
网站监控任务列表
查看监控任务配置
查看任务监控数据
创建网站监控任务
可使用的监测点
监测点运营商
修改监控任务配置
开启/停止监控任务
获取响应时间分布
删除网站监控任务
网站监控分组列表
创建网站监控分组
分配监控任务到分组
创建站点企业分组
分配任务到企业分组
查看最近一次的数据
查看历史快照
企业分组任务列表
网站子账号任务列表
服务监控
服务监控任务列表
查看监控任务配置
查看任务监控数据
创建服务监控任务
修改监控任务配置
开启/停止监控任务
删除服务监控任务
服务监控分组列表
创建服务监控分组
分配监控任务到分组
创建企业分组
分配任务到企业分组
查看任务统计数据
子账号监控任务列表
服务器监控
服务器监控任务列表
查看监控任务配置
查看任务监控数据
创建服务器监控任务
修改监控任务配置
开启/停止监控任务
删除服务器监控任务
服务器监控分组列表
创建个人监控分组
创建企业服务器分组
分配监控任务到分组
分配任务到企业分组
统计服务器数量
获取告警的服务器
查看任务统计数据
获取服务器的磁盘
获取服务器的网卡
告警设置
故障历史查询
网站监控告警设置
服务监控告警设置
服务器监控告警设置
获取任务告警消息
获取消息的通知历史
获取自定义告警消息
插件管理
插件列表
创建采集器
删除采集器
采集器任务统计
自定义告警
获取自定义告警规则
查看自定义告警规则
创建自定义告警规则
修改自定义告警规则
删除自定义告警规则
API监控
API监控任务列表
查看任务监控数据
查看最近一次的数据
API监控任务可用率
API监控任务响应时间
API监控任务正确率
API监控任务故障历史

URI

/v2/service/create.json

Method

POST

参数说明

Contenty-Type: application/json

可支持批量创建

公共参数:

   task_name:任务名称

   task_type:任务类型

   frequency:监控频率

   alert_setting: 告警设置

   use_agent:是否使用插件(0:不适用  1:使用)

   plugin_task_uselist_id:使用的关联插件ID,可通过插件API获得

其他参数:

 (Apache,Lighttpd,Nginx,Mongodb,Redis,Memcache)

      status_url:状态页面URL

 (MySQL)

      ip: MySQL服务器IP

      port: MySQL端口

      user: MySQL用户名

      password:MySQL密码

  (Tomcat)

      status_url:Tomcat状态页

      user:Tomcat用户名

      password:Tomcat密码

      appname:所要监控服务名

(IIS)

      logPath:iis服务器日志路径,C:\inetpub\logs\LogFiles\W3SVC1

  (SQLServer)

      ip: SQLServer服务器的IP地址

      port:SQLServer端口

      user:SQLServer用户名

      password:SQLServer密码

      appname:数据库名

  (Oracle)

      user:Oracle用户名

      password:Oracle密码

      appname:Oracle连接名

 

例:

  $post_array = array(

      array(

            ‘task_name’=>’apache_test’,

            ‘task_type’=>’apache’,

            ‘frequency’=>’5’,

            ‘status_url’=>’......’,

当您为任务设置告警时:

            ‘alert_setting’=>array(

               ‘alert’=>array(

                    ‘email’=>’user_id1,user_id2,....’,

                    ‘sms’=>’user_id1,user_id2,....’,

                    ‘msn’=>’user_id1,user_id2,....’,

                    ‘gtalk’=>’user_id1,user_id2,....’,

                    ‘remind’=>’user_id1,user_id2,....’,

                ),

               ‘scope’=>‘’,//任务公开范围(1:全企业用户  2:指定用户组 3:仅限本人 4:部分用户)  *企业用户才需要设置

               ‘organization’=>‘id1,id2,…’,//指定用户组的分组ID(只当‘scope’设置为2时才需设置)  *企业用户才需要设置

               ‘user_ids’=>’uid1,uid2,...’//指定用户(只当‘scope’设置为4时才需设置)    *企业用户才需要设置

             ),

           ),

当您不为任务设置告警时:

               ‘open_scope’=>‘’,//任务公开范围(1:全企业用户  2:指定用户组 3:仅限本人 4:部分用户) *企业用户才需要设置

               ‘organization’=>‘id1,id2,…’,//指定用户组的分组ID(只当‘scope’设置为2时才需设置)  *企业用户才需要设置

               ‘user_ids’=>’uid1,uid2,...’//指定用户(只当‘scope’设置为4时才需设置)      *企业用户才需要设置

   );

$post_data =   array(‘data’=>json_encode($post_array));

curl_setopt($ch,   CURLOPT_POSTFIELDS, $post_data);

结果(json)

成功将返回创建的任务的ID

失败状态码:400

一个例子:

curl -H "application/x-www-form-urlencoded" --data 'data=[{"task_name":"apache_test","task_type":"apache","frequency":"5",
"status_url":"http://59.63.184.65:8001/server-status","use_agent":"0","plugin_task_uselist_id":[],"alert_setting":{"alert":{"email":"286276,288389","sms":"286276,288389",
"msn":"286276,288389","gtalk":"286276,288389","remind":"286276,288389"},"scope":"1","organization":"","user_ids":""}}]' 
"https://api.jiankongbao.com/v2/service/create.json?access_token=95e9be13be110ce7a6f3b5de91ad0af479096efb"

说明:access_token通过获取访问token得到。

返回结果:

[
   {
       "task_id": 20501
   }
]