A AuthMS API Wiki API Reference iam.tianv.com →

POST /admin/tenants/{id}/webhooks

为租户注册事件回调 Webhook

租户服务 `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
id path string Yes 租户ID

Request Body

Schema: domain.CreateWebhookRequest

FieldTypeRequiredExampleConstraintsDescription
backoff_strategy domain.WebhookBackoffStrategy No
events array of

string

No
headers object No extra keys: `string`
max_retries integer No
secret string No
timeout_secs integer No
url string No

Responses

StatusDescriptionSchema
201创建成功dto.WebhookDetailResponse
400请求参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
403权限不足gitee_com_linmes_authms_base_dto.SimpleResponse
409资源冲突gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

domain.WebhookBackoffStrategy

string

dto.WebhookDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.WebhookResponse No
message string No
timestamp string No

dto.WebhookResponse

FieldTypeRequiredExampleConstraintsDescription
backoff_strategy string No exponential
created_at string No 2026-01-01T00:00:00Z
events array of

string

No ['["user.created"', '"user.updated"]']
headers string No {"X-Custom":"value"}
id string No 550e8400-e29b-41d4-a716-446655440000
is_active boolean No True
max_retries integer No 3
tenant_id string No tenant-123
timeout_secs integer No 10
updated_at string No 2026-01-01T00:00:00Z
url string No https://example.com/webhook

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No