创建 Webhook

创建 webhook。成功响应仅此次返回 ID 和 secret_token,并设置 Cache-Control: no-store。已有 webhook 无法通过 API 读取密钥。应用解除授权时,仅删除该账号下由该应用创建的 webhook,并向其保存的地址发送最后一条 authorization_revoked 通知,即使事件过滤器未包含它。手工创建及其他应用的 webhook 不受影响。投递限制见 Webhook 使用指南。 所有 v3 事件负载均包含 ULID 字符串 event_id,同一事件在不同 URL 及重试时共用,可用于通知去重。 OAuth 应用按「应用 + 账号」独立计配额,默认最多 50 条,百居易可按账号调整。手动、自助 token 创建及历史 webhook 共用账号自有配额:网页端手动创建上限为 3 条,通过 v3 使用自助 access token 创建上限为 5 条。调低配额不会停止已有 webhook 的投递。默认情况下,应用创建的 webhook 在业务事件投递收到 410 Gone 时会被删除,恢复投递需重新创建。手动及历史 webhook 保留,404 不触发删除。

Body Params
string
required

Webhook 端点 URL。

events
array of strings

要订阅的事件类型房源。如果省略,则默认为所有事件。

events
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json