其他
在调用 Sumsub 创建类接口前检查租户权益…
当需要通过 Sumsub API 创建 Level 或其他资源、且功能受租户 entitlement 限制时,先查询 allowedChecks 并在缺少权益时提前终止。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
在调用 Sumsub 创建类接口前检查租特定
解决思路
- 在构建或 POST payload 之前,运行 `bash ${CLAUDE_SKILL_DIR}/scripts/check_permissions.sh` 获取当前租户的允许权益。
- 解析脚本输出:先输出原始 Sumsub 响应体,最后一行是 `HTTP <code>`。
- 当输出为 `HTTP 200` 时,解析响应体 JSON 中的 `allowedChecks`;它是一个「权限 key → 人类可读 label」的映射,映射的 key 就是该租户已启用的权益。
- 如果 HTTP 状态不是 200,立即停止;把错误响应体展示给用户,不要继续后续操作。
- 在成功响应后,检查所需的 `BackgroundCheckTarget` key 是否存在于 `allowedChecks` 中;如果不存在,立即停止,不要构建或 POST payload。
- 如果所需 entitlement 缺失,告知用户缺少哪个 entitlement,并说明需要联系其 CSM 或 Sumsub Support 启用。
- `E_KYC` docset 需要 `E_KYC_TARGET` entitlement。
- `PROOF_OF_RESIDENCE` docset 需要 `POA` entitlement。
- `E_SIGN` docset 需要 `E_SIGN_TARGET` entitlement。
- `deviceIntelligenceSettings.enabled: true` 需要 `DEVICE_INTELLIGENCE` entitlement。
- `QUESTIONNAIRE` scoring 需要 `QUESTIONNAIRE_SCORING` entitlement。
- `QUESTIONNAIRE` attachments 需要 `QUESTIONNAIRE_ATTACHMENT` entitlement。
- NFC chip reading 需要 `NFC` entitlement。
- Video ident sessions 需要 `VIDEO_IDENT` entitlement。
- Reusable KYC via SDK 需要 `REUSABLE_KYC_SDK` entitlement。
- Known face search 需要 `KNOWN_FACE_SEARCH` entitlement。
- AML / watchlist step 需要 `WATCHLISTS` entitlement。
适用边界 · 注意事项
- 不适用于不需要按 Sumsub 租户权益进行门控的接口调用或本地逻辑。
- 不适用于没有 Sumsub tenant、无法执行该脚本/接口或没有访问权限的环境。
- 不适用于功能不依赖租户 entitlement、无需写入前检查权限的流程。