跳到正文

产品权限快照回查 ​

收到 oem.access_context.changed.v1 后,使用本应用服务身份查询事件目标成员的当前权限。

请求 ​

POST /open-platform/v1/applications/{id}/events/{event_id}/access-snapshot

以 GOODVISION_API_BASE 为入口,使用当前应用服务 Client 取得的 Bearer Token,Scope 为 openplatform.api.invoke,JSON 正文为 {}。应用需已启用成员权限能力;不要求给普通用户增加运营角色或机器权限。

id 是当前应用,event_id 是本应用已收到的原权限事件。平台从原事件确定客户空间、产品和成员;不接受额外客户、企业、Profile 或环境选择,也不提供客户或全体成员列表。另一应用的凭据不能查询该事件。

使用结果 ​

响应包含 application_id、environment、product_code、audience、organization、product_access、单个 members、entitlements、capabilities 和 generated_at,并设置 Cache-Control: no-store。

成员 membership_id 对应用户上下文的 space.membership_id,不能与 open_id、union_id 或登录身份标识互换。只有 product_access_allowed 明确为 true、身份和成员均为 active、产品访问为 trial 或 active,且 access_revision 不低于原事件时,才应用当前权限。未分类许可不返回 product_license_kind,不能推断为构建许可。

同一用户在两个应用中的权限、产品与订阅分别核验;union_id 相同不产生跨应用授权。支付成功、订阅激活或履约成功事件均不能替代本次回查。

失败与恢复 ​

收到事件先持久化并限制旧权限。401 时重新取得当前应用服务 Token;403/404 时核验应用、原事件及能力是否仍有效;503 时保留事件进行有界重试。响应缺字段、成员不匹配或版本不足时继续限制访问,不沿用旧权限。

相关文档:订阅生命周期 · 事件目录 · API 产品

开发者文档。第三方接入不需要内部运营平台权限。