文档中心

托管 Prometheus

联系人

TestDingTalkBotWebhook

测试钉钉群组机器人的连通性。

请求说明

托管 Prometheus 已在全球多个地域部署服务，旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅服务地址文档，根据业务所在地域，选择最合适的接入点。

请求方式：POST

请求地址：https://vmp.cn-beijing.volcengineapi.com?Action=TestDingTalkBotWebhook&Version=2021-03-03

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	TestDingTalkBotWebhook	接口名称。当前 API 的名称为 TestDingTalkBotWebhook。
Version	String	是	2021-03-03	接口版本。当前 API 的版本为 2021-03-03。
Address	String	是	https://oapi.dingtalk.com/robot/send?access_token=***	钉钉群组机器人 Webhook 地址，详情请参见钉钉用户文档。
SecretKey	String	否	zs0T***	钉钉群组机器人 Webhook 秘钥, 不能单独配置。当配置了钉钉机器人 Webhook 地址，且启用了签名校验功能时，需同步配置。
AtMobiles	Array of String	否	["133********"]	被 @ 人的手机号。
AtUserIds	Array of String	否	["********"]	被 @ 人的用户 ID。

请求示例

POST https://vmp.cn-beijing.volcengineapi.com?Action=TestDingTalkBotWebhook&Version=2021-03-03​
Content-Type: application/json​
{​
    "Address": "https://oapi.dingtalk.com/robot/send?access_token=***",​
    "SecretKey": "zs0T***",​
    "AtMobiles": [​
        "133********"​
    ],​
    "AtUserIds": [​
        "********"​
    ]​
}

返回参数

参数	类型	示例值	描述
StatusCode	Integer	200	HTTP 状态码。
ErrorMessage	String	timeout	HTTP 请求返回的错误信息。
DingTalkCode	Integer	9499	钉钉机器人发送消息后返回的状态码。
DingTalkMessage	String	Bad Request	钉钉机器人发送消息后返回的信息。

返回示例

HTTP/1.1: 200 OK​
Content-Type: application/json​
{​
    "ResponseMetadata": {​
        "RequestId": "20230604110420****100232280022D31",​
        "Action": "TestDingTalkBotWebhook",​
        "Version": "2021-03-03",​
        "Service": "vmp",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "StatusCode": 200,​
        "ErrorMessage": "timeout",​
        "DingTalkCode": 9499,​
        "DingTalkMessage": "Bad Request"​
    }​
}

错误码

本接口错误码如下表所示，公共错误码请参见公共错误码。

HTTP 状态码	错误码	错误信息	说明
400	InvalidParameter.{{parameter}}	The specified parameter {{parameter}} is invalid.	输入不合法，如工作区名称不合法等。
400	MissingParameter.{{parameter}}	The required parameter {{parameter}} is missing.	缺少必要的参数。
403	ProductUnsubscribed	You are not subscribed to VMP. Please go to the VMP console web page to subscribe to the service	当前账号未订阅 VMP 服务。

最近更新时间：2025.11.05 17:12:27

这个页面对您有帮助吗？

有用

无用