调用DescribeDingTalk获取钉钉通知列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeDingTalk

需要执行的操作。

取值：DescribeDingTalk
RuleActionName String 否 漏洞通知

通知名称。
PageSize Integer 否 20

分页查询时，显示每页数据的最大条数。
CurrentPage Integer 否 1

分页查询时，显示的当前页的页码。

返回数据

名称 类型 示例值 描述
RequestId String B256A525-7E42-4BB9-A27C-9017FDDFF1A2

结果的请求ID。
ActionList Array

通知列表。
GmtModified Long 1550828400000

修改时间。
Id Integer 1

通知消息ID。
AliUid Long 12312412341

用户的uid。
GmtCreate Long 1550828400000

创建时间。
Url String https://oapi.dingtalk.com/robot/send

通知参数。
IntervalTime Integer 1000

时间间隔。
ActionName String 告警通知

通知名称。
Status Integer 1

通知状态。

  • 0：关闭通知
  • 1：启用通知
ConfigList String [{\"type\":\"vul\",\"configItemList\":[{\"key\":\"key\", \"valueList\":\"123\"}]}]

消息的配置列表。
GroupIdList String "123,456"

分组ID列表。
DingTalkLang String zh

通知的语言。

  • zh：中文
  • en：英文
PageInfo Struct

分页信息。
PageSize Integer 20

分页查询时，显示每页数据的最大条数。
TotalCount Integer 1

消息总数。
CurrentPage Integer 1

分页查询时，显示的当前页的页码。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeDingTalk
&<公共请求参数>

正常返回示例

XML 格式 

<data >
    <PageInfo>
        <PageSize>20</PageSize>
        <CurrentPage>1</CurrentPage>
        <TotalCount>1</TotalCount>
    </PageInfo>
    <ActionList>
        <ActionName>告警通知</ActionName>
        <GmtCreate>1550828400000</GmtCreate>
        <GmtModified>1550828400000</GmtModified>
        <IntervalTime>1000</IntervalTime>
        <Id>1</Id>
        <Url>https://oapi.dingtalk.com/robot/send</Url>
        <AliUid>12312412341</AliUid>
        <configList>[{"type":"vul","configItemList":[{"key":"key", "valueList":"123"}]}]</configList>
        <groupIdList>123,456</groupIdList>
    </ActionList>
</data >
<requestId>B256A525-7E42-4BB9-A27C-9017FDDFF1A2</requestId>

JSON 格式 

{
  "data ": {
    "PageInfo": {
      "PageSize": 20,
      "CurrentPage": 1,
      "TotalCount":1
    },
    "ActionList": [{
      "ActionName": "告警通知",
      "GmtCreate": "1550828400000",
      "GmtModified": "1550828400000",
      "IntervalTime": 1000,
      "Id": 1,
      "Url": "https://oapi.dingtalk.com/robot/send",
      "AliUid": 12312412341,
      "configList":"[{\"type\":\"vul\",\"configItemList\":[{\"key\":\"key\", \"valueList\":\"123\"}]}]",
      "groupIdList":"123,456"
    }]
  },
  "requestId": "B256A525-7E42-4BB9-A27C-9017FDDFF1A2"
 
}

错误码

访问错误中心查看更多错误码。