SuperAPI AI 工具集

salla-app-settings

通用与其它

查看项目

更新于 10-16 01:12

技能介绍

用途:为 Salla 应用配置按商家(per-merchant)的设置,覆盖公开、私有和通讯类应用。发货类应用没有商家设置表单,Portal 会拒绝其 POST /settings,应改用 salla_shipping 的相关技能。

主要能力(通过 Salla Partners MCP 工具,均需 app_id):

  • salla_settings / define_form:注册商家设置表单(字段对象数组)。
  • salla_settings / set_validation_url:设置服务端校验 URL,仅做校验不存储;该端点公开且无签名。
  • salla_settings / list_features:读取支持的功能(通讯类应用才有意义,非通讯类返回 404 属正常)。
  • salla_settings / set_features:设置支持的功能,通讯类应用发布前必需。

使用方式:先连接 Salla Partners MCP;会话过期需重跑登录流程。设计 schema 时字段必须使用真实的 type+format 组合,仅扁平结构,id 用 snake_case,必填字段带默认值,标签以阿拉伯语优先;密钥用 format: password(服务端读取,不可公开)。字段 schema 变更只能通过 define_form,无 Portal 手工编辑途径。运行时写值与读取用 Admin API:GET/POST https://api.salla.dev/admin/v2/apps/{app_id}/settings,需要 Bearer access_token。关键规则:每次 POST 必须发送全部键,缺键会被置为 null,没有部分更新。app.settings.updated 是存储的事实来源,携带完整 settings,应在每次激活/更新时持久化;布尔值可能以字符串 "true" 到达,需做强制转换。在 App Function 内可通过 context.settings 直接读取,建议用可选链。

限制:没有用于写入按商家值的 MCP 工具,写值须在运行时用商家 access_token 完成;POST 响应体不应解析,应以 2xx 加后续 GET 或 webhook 确认。公开字段可被店面片段通过 salla.config.get('app.<key>') 读取,缺失或私有键会读到 undefined。其他费用、平台支持范围等资料未提供。