SuperAPI AI 工具集

sumsub-check-databases

安全与审计

查看项目

更新于 10-16 01:09

技能介绍

用途:查询 Sumsub 面向某国家提供的数据库(非证件 eKYC)核验源,返回各源的租户启用状态,以及它们如何接入验证等级,用于在建等级前判断数据库核验是否可用。仅覆盖 KYC 个人,企业(KYB)源暂未开放。

接口:GET https://api.sumsub.com/resources/api/agent/settings/checkSources?country=<country>。country 为 ISO alpha-3(如 DEU);传入国家名需先转换。省略 country 返回全量目录,条目众多易撑大上下文,建议尽量带 country,未指定时先询问。无法识别的代码不报错,返回 200 与空 checkSources 列表。

鉴权:App Token + secret,仅限沙箱。环境变量 SUMSUB_APP_TOKEN(sbx: 开头,脚本拒绝非沙箱令牌)、SUMSUB_SECRET_KEY,SUMSUB_BASE 可选,默认 https://api.sumsub.com。

用法:bash ${CLAUDE_SKILL_DIR}/scripts/check_databases.sh <country>,输出原始响应体加 HTTP 状态码。

关键字段:sourceId、name、description、dataSources、country、checkType、confirmationType(otp/oAuth/eID)、status(ENABLED/SANDBOX_ONLY/DISABLED)、validationReady、stepsReady、supportedDocuments、required/optionalInputFields、selfieRequirement(REQUIRED/ADDITIONAL/缺省)、outputFields、violations。输入字段为机器字段名(如 number、dob、address.postCode),非展示标签;自拍不在输入字段中,需读 selfieRequirement。

处理规则:状态非 200 应停止并展示错误;空列表不算错误,说明该国无 KYC 数据库源或代码有误,可核对 alpha-3 后重试,不得编造源,可回退证件核验。status 与查询环境无关:ENABLED 可用;SANDBOX_ONLY 仅沙箱;DISABLED 不可用。

放置:源通过等级 checkSourceSettings.countrySettings[] 接入。validationReady 对应数据库校验(保留证件步骤,源挂顶层);stepsReady 指向非证件步骤(单独或嵌入已有步骤)。非证件身份还需 E_KYC_TARGET 权限。启用源无公开 API,需在面板 Databases → Available products 自助启用,或联系客户成功经理/支持。缺失源应提示缺口及影响,由用户决定,不可静默降级或直接硬停。