订阅资源发布或知识库更新
/api/webhooks/endpoints/{id}/subscriptions要求 Cookie、CSRF、owner 与 api-token 强验证。已审核端点必须启用,目标当前公开;资源与知识库合计最多 100 个订阅。省略 targetKind 保留资源协议:维度内 OR、跨维度 AND,加载器和版本匹配同一物理发布。知识库独立流不接受发布筛选。新订阅从锁定的当前序号之后开始;改地址、轮换密钥、停用/启用及应用撤权均取消旧任务并推进两种订阅边界。
网站 Cookie 会话 + CSRF + 二次验证(api-token,300 秒);请在同源网站环境调用
路径参数
idstring必填长度 ≥ 1
请求体 必填
application/jsonbodyobject
bodyobject方案 1 · object
targetKindstring可选"resource"resourceSlugstring必填长度 ≥ 1 · 长度 ≤ 200
eventsstring[]可选默认值 ["release.published","release.updated","release.withdrawn"]条目数 ≥ 1 · 条目数 ≤ 100
eventsstring[]可选默认值 ["release.published","release.updated","release.withdrawn"][]string"release.published""release.updated""release.withdrawn"长度 ≥ 1 · 长度 ≤ 100
loadersstring[]可选默认值 []条目数 ≤ 100
loadersstring[]可选默认值 [][]string长度 ≥ 1 · 长度 ≤ 100
mcVersionsstring[]可选默认值 []条目数 ≤ 100
mcVersionsstring[]可选默认值 [][]string长度 ≥ 1 · 长度 ≤ 100
releaseTypesstring[]可选默认值 ["release"]条目数 ≥ 1 · 条目数 ≤ 100
releaseTypesstring[]可选默认值 ["release"][]string"release""beta""alpha"长度 ≥ 1 · 长度 ≤ 100
方案 2 · object
targetKindstring必填"knowledge_base"knowledgeBaseSlugstring必填长度 ≥ 1 · 长度 ≤ 200
eventsstring[]可选默认值 ["knowledge.published","knowledge.updated","knowledge.page.published","knowledge.page.updated","knowledge.page.withdrawn","knowledge.withdrawn","knowledge.archived","knowledge.restored"]条目数 ≥ 1 · 条目数 ≤ 100
eventsstring[]可选默认值 ["knowledge.published","knowledge.updated","knowledge.page.published","knowledge.page.updated","knowledge.page.withdrawn","knowledge.withdrawn","knowledge.archived","knowledge.restored"][]string"knowledge.published""knowledge.updated""knowledge.page.published""knowledge.page.updated""knowledge.page.withdrawn""knowledge.withdrawn""knowledge.archived""knowledge.restored"长度 ≥ 1 · 长度 ≤ 100
返回值
成功;无额外 data 信封。
subscriptionobject必填
subscriptionobject必填方案 1 · object
idstring必填resourceIdstring必填resourceSlugstring | null必填eventsstring[]必填
eventsstring[]必填[]string"release.published""release.updated""release.withdrawn"loadersstring[]必填
loadersstring[]必填[]stringmcVersionsstring[]必填
mcVersionsstring[]必填[]stringreleaseTypesstring[]必填
releaseTypesstring[]必填[]string"release""beta""alpha"createdAtstring必填格式:date-time
方案 2 · object
idstring必填targetKindstring必填"knowledge_base"knowledgeBaseIdstring必填knowledgeBaseSlugstring | null必填eventsstring[]必填
eventsstring[]必填[]string"knowledge.published""knowledge.updated""knowledge.page.published""knowledge.page.updated""knowledge.page.withdrawn""knowledge.withdrawn""knowledge.archived""knowledge.restored"loadersstring[]必填条目数 ≤ 0
loadersstring[]必填[]stringmcVersionsstring[]必填条目数 ≤ 0
mcVersionsstring[]必填[]stringreleaseTypesstring[]必填条目数 ≤ 0
releaseTypesstring[]必填[]stringcreatedAtstring必填格式:date-time
响应头
Cache-Controlstring可选"no-store"接口信息
接口: POST /api/webhooks/endpoints/{id}/subscriptions
operationId: createWebhookSubscription
要求 Cookie、CSRF、owner 与 api-token 强验证。已审核端点必须启用,目标当前公开;资源与知识库合计最多 100 个订阅。省略 targetKind 保留资源协议:维度内 OR、跨维度 AND,加载器和版本匹配同一物理发布。知识库独立流不接受发布筛选。新订阅从锁定的当前序号之后开始;改地址、轮换密钥、停用/启用及应用撤权均取消旧任务并推进两种订阅边界。
参数:
pathid(必填)bodytargetKindbodyresourceSlugbodyeventsbodyloadersbodymcVersionsbodyreleaseTypesbodyknowledgeBaseSlug