**版本：202601**

# 查询 Webhook 列表

**GET** `/openapi/2026-01/webhooks`

返回店铺已注册的所有 Webhook 列表。

## 请求

**Query参数**

- `address` string

  Webhook 通知 URL，例如：[https://example.com/webhook](https://example.com/webhook)
- `topic` string

  Webhook 主题
- `created_at_min` string

  最早创建时间
- `created_at_max` string

  最晚创建时间
- `updated_at_min` string

  最早更新时间
- `updated_at_max` string

  最晚更新时间
- `page_size` int32

  每页记录数
- `page` int32

  页码（从 1 开始），与 cursor 互斥
- `cursor` string

  分页游标

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `webhooks` object[]

    Webhook 列表

    *   Array \[

    - `id` string

      Webhook 的Webhook ID
    - `address` string

      Webhook 通知 URL，如 [https://example.com/webhook](https://example.com/webhook)
    - `topic` string

      Webhook 的主题
    - `created_at` string

      Webhook 的创建时间
    - `updated_at` string

      Webhook 的更新时间
    - `format` string

      Webhook 的格式
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "webhooks": [
      {
        "id": "string",
        "address": "string",
        "topic": "string",
        "created_at": "string",
        "updated_at": "string",
        "format": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```