POST `/admin/tenants/{tenant_id}/webhooks`

为租户注册事件回调 Webhook

租户服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`tenant_id`	`path`	`string`	是				租户ID

请求体

Schema： service-tenant/internal/handler/dto.CreateWebhookRequest

字段	类型	必填	示例	约束	描述
`backoff_strategy`	`domain.WebhookBackoffStrategy`	否
`events`	array of string	否
`headers`	`object`	否		extra keys: `string`
`max_retries`	`integer`	否
`secret`	`string`	否
`timeout_secs`	`integer`	否
`url`	`string`	否

响应

状态	描述	Schema
201	创建成功	`service-tenant/internal/handler/dto.WebhookDetailResponse`
400	请求参数错误	`service-core/base/dto.SimpleResponse`
401	未认证	`service-core/base/dto.SimpleResponse`
403	权限不足	`service-core/base/dto.SimpleResponse`
409	资源冲突	`service-core/base/dto.SimpleResponse`
500	服务器内部错误	`service-core/base/dto.SimpleResponse`

引用的 Schema

domain.WebhookBackoffStrategy

string

service-core/base/dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-tenant/internal/handler/dto.WebhookDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-tenant/internal/handler/dto.WebhookResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-tenant/internal/handler/dto.WebhookResponse

字段	类型	必填	示例	约束	描述
`backoff_strategy`	`string`	否	`exponential`
`created_at`	`string`	否	`2026-01-01T00:00:00Z`
`events`	array of string	否	`['["user.created"', '"user.updated"]']`
`headers`	`string`	否	`{"X-Custom":"value"}`
`id`	`string`	否	`550e8400-e29b-41d4-a716-446655440000`
`is_active`	`boolean`	否	`True`
`max_retries`	`integer`	否	`3`
`tenant_id`	`string`	否	`tenant-123`
`timeout_secs`	`integer`	否	`10`
`updated_at`	`string`	否	`2026-01-01T00:00:00Z`
`url`	`string`	否	`https://example.com/webhook`

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓