创建 Webhook

POST 
/openapi/2026-07/webhooks

创建包含通知 URL、事件名称和格式的 Webhook。

请求

application/json

请求体

请求体必填

webhook object必填

Webhook 信息

addressstring必填

Webhook 通知 URL，如 https://example.com/webhook

topicstring必填

Webhook 的主题

示例

{
  "webhook": {
    "address": "string",
    "topic": "string"
  }
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

webhook object

Webhook 信息

idstring

Webhook 的Webhook ID

addressstring

Webhook 通知 URL，如 https://example.com/webhook

topicstring

Webhook 的主题

created_atstring

Webhook 的创建时间

updated_atstring

Webhook 的更新时间

formatstring

Webhook 的格式

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "webhook": {
      "id": "string",
      "address": "string",
      "topic": "string",
      "created_at": "string",
      "updated_at": "string",
      "format": "string"
    }
  }
}