SuperAPI AI 工具集

b2c-scapi-admin

编程与开发

查看项目

更新于 10-16 01:09

技能介绍

用途:构建后端集成,或在标准 Admin API 下管理 Commerce 数据。店面流程应改用 b2c-scapi-shopper 技能。

主要能力:scapi_search 离线检索内置标准契约,定位 method、path、operationId,并查看参数、字段与安全作用域,返回精简投影;scapi_execute 执行受支持的 Admin JSON 操作,使用已配置的 Account Manager 认证及自动的操作/租户作用域;scapi_schemas_list 获取含自定义属性和 API 的实时租户 schema;scapi_custom_apis_get_status 查询自定义注册。docs_search/docs_read 提供平台语义、限制与认证设置说明。

使用方式:当 B2C MCP 可用时,优先使用专用任务工具,否则通过 resources 或 skills_read 阅读 skill://mcp/b2c-mcp-scapi/SKILL.md 一次,再使用 skillRead: true。CLI/集成开发可用 b2c scapi schemas list 与 b2c scapi schemas get <family> <name> <version> 获取实时契约。仅在选择外部客户端、令牌流程或批量导入时阅读集成示例。

执行注意:使用已配置的 short code、tenant 与 site 值;Admin 认证需要 Account Manager 客户端、API 授予及 SALESFORCE_COMMERCE_API:<tenant_id>,SLAS 凭据不能替代 Admin 凭据。使用前检查操作,示例仅供参考;租户特定字段以实时 schema 为准;版本相关语义查官方文档。区分创建与更新,PUT 可能两者兼有;先验证存在性与意图,再读回有意义字段;重试失败前先检查先前写入。在 API 层分页/过滤,只返回 ID、选定字段、总数/hasMore 与错误,不输出整棵响应树或打印凭据。安全基于方法,POST 搜索可能需要定向允许规则;需确认的代码模式请求会停止,不得绕过。

限制:代码模式不支持自定义执行与二进制传输,需改用合适的集成客户端;没有 CLI 代码模式等价物;涉及 OAuth 作用域、集成模式(ETL、同步、批量导入)、b2c-config 凭据与优先级等条件性参考。官方文档涵盖 Admin API 授权、auth-z 作用域目录、超时限制、限流与库存 impex 最佳实践。其余具体定价、平台支持等信息暂未提供。