校验webhook地址有效性。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
gemp:CheckWebhook |
none |
*全部资源
|
无 | 无 |
请求语法
POST /services/check/webhook HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求 Body。 |
body |
| clientToken |
string |
否 |
幂等校验。 |
FD200FAE-E98F-496E-BFE6-4CE61E59A2E9 |
| webhook |
string |
否 |
webook 地址。 |
https://oapi.dingtalk.com/robot/send?access_token=XXX |
| webhookType |
string |
否 |
webhook 地址类型:
|
DING_GROUP |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应结构。 |
||
| requestId |
string |
请求 ID。 |
FD200FAE-E98F-496E-BFE6-4CE61E59A2E9 |
示例
正常返回示例
JSON格式
{
"requestId": "FD200FAE-E98F-496E-BFE6-4CE61E59A2E9"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 403 | WebhookVerificationError | A webhook verification error occurred. | webhook校验异常 |
| 403 | WebhookAddressFormatError | The webhook address format is invalid. | webhook地址格式错误 |
| 403 | WebhookAccessRestricts | Traffic is restricted for webhook access. | webhook访问限流 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。
该文章对您有帮助吗?