接口功能概述

第三方应用可以直接通过调用该接口,向特定租户的特定产品中添加专项类别的应用巡检 (==注意使用V2.0授权方式==)

接口说明

  • 调用地址
正式:https://zenith.fdcyun.com/v20/api/pub/patrol/insert-data-rule.svc
测试:https://planet-test.fdcyun.com/v20/api/pub/patrol/insert-data-rule.svc
开发:http://localhost:8022/v20/api/pub/patrol/insert-data-rule.svc
  • 调用方式:POST
  • 请求头信息(header)
x-token:xxxxx //调用服务云[认证接口]得到的token,未传输此头的请求无法获取数据
x-custid:xxxx //客户主数据GUID
Content-Type: application/json; charset=utf-8
  • 请求体(body)
[
    {
        "biz_id": "1",// 业务系统自己的id,用于后期回调或更新
        "product_id": "641", // 接口取得 参考获取产品列表
        "subsystem_code": "641", // 接口取得 参考获取(产品对应)子系统列表接口
        "name": "检查房间总价不等于面积乘以单价的合同", // 规则名称
        "type": "完整性", //规则类别
        "subsystem": "项目主数据管理", //【必填】 子系统
        "function_name": "合同管理", //业务分类,如合同管理
        "description": "", // 规则描述
        "modify_reason":"业务变更,同步调整SQL",//调整原因
        "sql": "select top 10 * from myuser", // 【必填】 查询SQL 紧支持查询接口
        "scope": "1",  //【必填】1集团级  2公司级 3项目级
        "task_code":"20200421-9987" //任务编号
    }
]
数据巡检有如下校验规则,任意一个不满足将不会添加:
    1、规则名称不能为空
    2、SQL语句不能为空
    3、公司级别的规则 需包含公司GUID、公司名称
    4、项目级别的规则 需包含公司GUID、公司名称、项目GUID、项目名称
    5、SQL语句中不允许使用关键字alter、create、drop、truncate、exec、xp_cmdshell、delete
    6、规则级别只能是:集团级、公司级、项目级中的一个
    7、规则类别只能是:准确性、完整性、规范性中的一个
    8、传入的子系统必须在服务云平台存在
    9、限制SQL查询的结果不能超过1000条 (已作废)
    10、同一套产品同一个子系统下专项巡检规则名称不能重复
  • 返回结果
成功返回,http状态码为 200
{
    "success_count":11, //添加成功的记录数
    "data":[{}], //未添加成功的规则列表
    "error_message":""  //未添加成的规则的原因,多条规则的原因使用;分割
}

失败返回,http状态码为 500
//失败返回
{
    "Message": "应用ID不存在",
    "ExceptionType":"System.Exception",
    "xxx": "xxx" //后续扩展
}
  • 返回代码说明
代码 说明
200 表示请求成功
403 未授权
500 具体错误信息

更新说明