获取当前账号可见的 Webhook Endpoint 列表。
Webhook 当前为 Beta 功能,接口、字段和行为可能在后续版本中调整。
GET /api/v1/forward/webhook/endpoints
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或管理员 SAT> |
查询参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
limit | integer | 否 | 每页数量,默认 20,取值范围 1-100。 |
after_id | string | 否 | 上一页响应中的 last_id,用于读取下一页。 |
示例请求
示例响应
HTTP 200 OK
data 为 [],first_id 和 last_id 为 null,has_more 为 false。
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
data | object[] | 当前页的 Endpoint 对象。 |
first_id | string/null | 当前页第一条 Endpoint ID。 |
last_id | string/null | 当前页最后一条 Endpoint ID,可作为下一页的 after_id。 |
has_more | boolean | 是否还有下一页。 |
错误
| HTTP | Type | 触发条件 |
|---|---|---|
400 | invalid_request_error | 分页参数不合法。 |
401 | authentication_error | 认证信息缺失、无效或已过期。 |
403 | permission_error | 当前令牌不能管理 Webhook。 |
500/502/503 | api_error | 服务暂时不可用。 |

