业务设置独立为 config 域(编码变更)
销售模块的 25 项业务设置(共 100 个接口)由 sales.config.* 迁至 config.sales.*,
所需授权范围由 sales:read / sales:write 改为 config:read / config:write。
旧编码即刻失效,继续使用会返回 92201 接口未登记或已停用。
为什么要拆
业务设置横跨销售、采购、财务等多个模块,原先按所属模块归域会让同类接口分散到各处;
独立成域后,一次 config:read 即可覆盖全部模块的设置查询,权限也能与业务数据分开授予
——比如只允许读取配置项、不允许读取客户与订单。
怎么改
编码规则由 sales.config. + 配置项,变为 config. + 模块 + . + 配置项:
| 旧编码 | 新编码 |
|---|---|
sales.config.lead-source | config.sales.lead-source |
sales.config.lead-source.create | config.sales.lead-source.create |
sales.config.industry.update | config.sales.industry.update |
25 个配置项标识本身不变,只是前缀与域归属调整。完整清单见 开放接口清单。
⚠️ 需要重新授权
config 是新增的范围词汇。在此之前完成授权的凭证不包含该域——
即便原先勾了 sales:read,也读不到业务设置。
- OAuth 凭证:重新走一次授权流程,勾选
config:read/config:write - AppKey:授权范围创建时固定、之后不可修改,需新建一个勾选了
config范围的 AppKey,切换完成后再吊销旧的,以免中断调用
同批变化
同时新增了 inventory 范围词汇(库存),接口登记正在进行中,稍后另行公告。