跳到主要内容

业务设置独立为 config 域(编码变更)

Avery
Risemap 开放平台

销售模块的 25 项业务设置(共 100 个接口)由 sales.config.* 迁至 config.sales.*, 所需授权范围由 sales:read / sales:write 改为 config:read / config:write。

旧编码即刻失效,继续使用会返回 92201 接口未登记或已停用。

为什么要拆​

业务设置横跨销售、采购、财务等多个模块,原先按所属模块归域会让同类接口分散到各处; 独立成域后,一次 config:read 即可覆盖全部模块的设置查询,权限也能与业务数据分开授予 ——比如只允许读取配置项、不允许读取客户与订单。

怎么改​

编码规则由 sales.config. + 配置项,变为 config. + 模块 + . + 配置项:

旧编码新编码
sales.config.lead-sourceconfig.sales.lead-source
sales.config.lead-source.createconfig.sales.lead-source.create
sales.config.industry.updateconfig.sales.industry.update

25 个配置项标识本身不变,只是前缀与域归属调整。完整清单见 开放接口清单。

⚠️ 需要重新授权​

config 是新增的范围词汇。在此之前完成授权的凭证不包含该域—— 即便原先勾了 sales:read,也读不到业务设置。

  • OAuth 凭证:重新走一次授权流程,勾选 config:read / config:write
  • AppKey:授权范围创建时固定、之后不可修改,需新建一个勾选了 config 范围的 AppKey,切换完成后再吊销旧的,以免中断调用

同批变化​

同时新增了 inventory 范围词汇(库存),接口登记正在进行中,稍后另行公告。