1. 接口描述
接口请求域名: ssa.tencentcloudapi.com 。
查询【通用字段】【泄露监测数据列表】
默认接口请求频率限制:20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:SaDivulgeDataQueryPub。 |
Version | 是 | String | 公共参数,本接口取值:2018-06-08。 |
Region | 否 | String | 公共参数,本接口不需要传递此参数。 |
QueryKey | 是 | String | 模糊查询字段(针对appid或者uin) 示例值:2312131 |
EventName | 是 | String | 安全事件名称 示例值:test |
DivulgeSoure | 是 | String | 监控源 0:全部 1:GitHub 2:暗网 默认值1 示例值:1 |
Asset | 是 | String | 受影响资产 示例值:"" |
RuleName | 是 | String | 命中主题集下的规则topic名称 示例值:test |
RuleId | 是 | String | 命中主题集下的规则topic唯一id 示例值:"0" |
Level | 是 | String | 风险等级 -1:未知 1:低危 2:中危 3:高危 4:严重 示例值:1,2,3,4 |
Status | 是 | String | 安全事件处理状态 -1:未知 1:待处理 2:已处理 3:误报 4:已忽略 5:已知晓 6:已信任 示例值:1 |
StartTime | 是 | String | 起始时间 示例值:2020-04-10 16:01:14 |
EndTime | 是 | String | 结束时间 示例值:2022-04-12 10:56:16 |
Offset | 是 | String | 查询起始地址 示例值:1 |
Limit | 是 | String | 查询个数 示例值:20 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
Data | SaDivulgeDataQueryPubList | 自定义泄露事件列表 |
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 自定义泄露监测列表
输入示例
POST / HTTP/1.1
Host: ssa.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SaDivulgeDataQueryPub
<公共请求参数>
{
"Status": "0",
"DivulgeSoure": "0",
"RuleId": "0",
"RuleName": "",
"EventName": "",
"Limit": "5",
"Asset": "",
"StartTime": "2022-04-05 00:00:00",
"Offset": "0",
"QueryKey": "",
"Level": "1,2,3,4",
"EndTime": "2022-04-12 23:59:59"
}
输出示例
{
"Response": {
"Data": {
"Count": 641,
"List": [
{
"Id": "50561",
"Uin": "1445149556",
"AppId": "1251001047",
"EventName": "subash2001/kernel_realme_RMX1821",
"DivulgeSoure": "1",
"Asset": "",
"RuleName": "test",
"RuleId": "2946",
"RuleWord": "gdb filename test",
"ScanUrl": "https://github.com/subash2001/kernel_realme_RMX1821/blob/8d03dd3a8fc7b828f8141415b955ede6623959f8/lib/Kconfig.debug",
"ScanCount": "1",
"Level": "4",
"Status": "1",
"EventTime": "2022-04-12 11:22:20",
"InsertTime": "2022-04-12 11:22:20",
"UpdateTime": "2022-04-12 11:22:20"
},
{
"Id": "50560",
"Uin": "1445149556",
"AppId": "1251001047",
"EventName": "FrontendGod0123/angular-mst-store",
"DivulgeSoure": "1",
"Asset": "",
"RuleName": "test",
"RuleId": "2946",
"RuleWord": "gdb filename test",
"ScanUrl": "https://github.com/FrontendGod0123/angular-mst-store/blob/1aaafce2e72a0e330fd5670fd24cb0a83508fc78/yarn.lock",
"ScanCount": "1",
"Level": "4",
"Status": "1",
"EventTime": "2022-04-12 11:22:20",
"InsertTime": "2022-04-12 11:22:20",
"UpdateTime": "2022-04-12 11:22:20"
},
{
"Id": "48397",
"Uin": "1445149556",
"AppId": "1251001047",
"EventName": "ldq1128/ldqtest",
"DivulgeSoure": "1",
"Asset": "",
"RuleName": "快乐种子",
"RuleId": "2229",
"RuleWord": "广东快乐种子科技有限公司",
"ScanUrl": "https://github.com/ldq1128/ldqtest/blob/2f7a79346aa3265093e502892442c31d35db73bd/Python_jobs_cleaned.csv",
"ScanCount": "49",
"Level": "4",
"Status": "1",
"EventTime": "2022-04-12 11:18:34",
"InsertTime": "2022-03-18 21:32:32",
"UpdateTime": "2022-04-12 11:18:34"
},
{
"Id": "48325",
"Uin": "1445149556",
"AppId": "1251001047",
"EventName": "ammadkh/devices",
"DivulgeSoure": "1",
"Asset": "",
"RuleName": "dsad",
"RuleId": "3675",
"RuleWord": "dsadsadsadsad",
"ScanUrl": "https://github.com/ammadkh/devices/blob/0059d0ab48fd29f960b9b1642db49c919ec06445/data/dummy-data.js",
"ScanCount": "54",
"Level": "4",
"Status": "1",
"EventTime": "2022-04-12 09:02:38",
"InsertTime": "2022-03-18 11:57:29",
"UpdateTime": "2022-04-12 09:02:38"
},
{
"Id": "48161",
"Uin": "1445149556",
"AppId": "1251001047",
"EventName": "immanuelMM/React-theme-1",
"DivulgeSoure": "1",
"Asset": "",
"RuleName": "dsad",
"RuleId": "3675",
"RuleWord": "dsadsadsadsad",
"ScanUrl": "https://github.com/immanuelMM/React-theme-1/blob/9ebc124f046a4d77632bc453b4bf8641f785ce9e/src/components/Services/index.js",
"ScanCount": "60",
"Level": "4",
"Status": "1",
"EventTime": "2022-04-12 09:02:38",
"InsertTime": "2022-03-07 16:01:30",
"UpdateTime": "2022-04-12 09:02:38"
}
]
},
"RequestId": "978a07dd-f787-44cf-ad3b-2f508c55358e"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
AuthFailure | CAM签名/鉴权错误。 |
FailedOperation | 操作失败。 |
InternalError.ParamError | 参数校验失败。 |