TestLarkBotWebhook--托管 Prometheus-火山引擎

文档中心

立即注册

导航

TestLarkBotWebhook

最近更新时间：2024.09.03 15:42:19首次发布时间：2024.08.16 17:03:02

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

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com/?Action=TestLarkBotWebhook&Version=2021-03-03

请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	TestLarkBotWebhook	接口名称。当前 API 的名称为 `TestLarkBotWebhook`。
Version	String	是	2021-03-03	接口版本。当前 API 的版本为 `2021-03-03`。
Address	String	是	https://open.feishu.cn/open-apis/bot/v2/hook/f19***	飞书群组机器人 webhook 地址。详情请参见飞书开放文档。
SecretKey	String	否	zs0T***	飞书群组机器人 Webhook 秘钥, 不能单独存在。当配置了飞书群组机器人 Webhook 地址，且启用了签名校验功能时，需同步配置。

请求示例

POST https://open.volcengineapi.com/?Action=TestLarkBotWebhook&Version=2021-03-03
Content-Type: application/json
{
    "Address": "https://open.feishu.cn/open-apis/bot/v2/hook/f19***",
    "SecretKey": "zs0T***"
}

返回参数

参数	类型	示例值	描述
StatusCode	Integer	200	HTTP 状态码。
ErrorMessage	String	timeout	HTTP 请求返回的错误信息。
LarkCode	Integer	0	飞书机器人发送消息后返回的状态码。
LarkMessage	String	ok	飞书机器人发送消息后返回的状态码。

返回示例

HTTP/1.1: 200 OK
Content-Type: application/json
{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "TestLarkBotWebhook",
        "Version": "2021-03-03",
        "Service": "vmp",
        "Region": "cn-north-1"
    },
    "Result": {
        "StatusCode": 200,
        "ErrorMessage": "timeout",
        "LarkCode": 0,
        "LarkMessage": "ok"
    }
}

错误码

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

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 the Volcengine Managed Service for Prometheus (VMP). Please go to the VMP console web page to subscribe to the service	当前账号未订阅 VMP 服务。