{ "generatedAt": "2026-04-17 20:34:19", "generatedAtLocal": "2026-04-17 20:34:19", "source": "remote", "filter": { "platform": { "value": "web", "label": "网页端" }, "project": { "value": "all", "label": "全部" } }, "module": { "name": "快递编码管理模块", "key": "setting.express", "folder": "setting.express", "interfaceCount": 6 }, "changes": { "fromPreviousSnapshot": { "moduleAdded": false, "moduleRenamed": false, "interfaceChanges": { "addedMethods": [], "deletedMethods": [], "paramsUpdatedMethods": [], "responseUpdatedMethods": [] } } }, "interfaces": [ { "method": "index.getExpressList", "title": "合并后的快递列表", "description": "合并后的快递列表", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [], "params": [ { "name": "systemOnly", "type": "boolean", "required": false, "description": "可选,是否仅返回系统基础快递列表;默认不传或 false 时返回合并仓库设置的快递列表;systemOnly=true 时只返回系统基础快递列表。" } ], "response": [] }, { "method": "setting.express.list", "title": "查询当前仓库范围的快递映射列表,支持 where + pagination", "description": "查询当前仓库范围的快递映射列表,支持 where + pagination", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "pagination", "type": "object", "required": false, "description": "分页参数,支持 page / pageSize,兼容 currentPage / page_size / size" }, { "name": "where", "type": "object", "required": false, "description": "统一 where 条件对象;推荐使用 { operator, value, type } 标准结构" } ], "response": [] }, { "method": "setting.express.listBase", "title": "返回系统快递基础列表(系统级别基础快递,不含仓库自定义)", "description": "返回系统快递基础列表(系统级别基础快递,不含仓库自定义)", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [], "params": [], "response": [] }, { "method": "setting.express.create", "title": "创建快递映射,仅写入已实现字段(code、name、platform 等)", "description": "创建快递映射,仅写入已实现字段(code、name、platform 等)", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "code", "type": "string", "required": true, "description": "快递编码" }, { "name": "name", "type": "string", "required": true, "description": "快递名称" }, { "name": "platform", "type": "string", "required": false, "description": "平台标识(可选)" } ], "response": [] }, { "method": "setting.express.checkCodeUnique", "title": "校验快递编码在当前仓库/主体维度唯一性,仅支持 code 与可选 id 排除自身", "description": "校验快递编码在当前仓库/主体维度唯一性,仅支持 code 与可选 id 排除自身", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "code", "type": "string", "required": true, "description": "待校验的快递编码" }, { "name": "id", "type": "number", "required": false, "description": "排除自身 id(更新时使用)" } ], "response": [] }, { "method": "setting.express.update", "title": "更新快递映射,仅更新已实现字段(例如 name、platform)", "description": "更新快递映射,仅更新已实现字段(例如 name、platform)", "endpoint": "/system", "authRequired": false, "loginRequired": true, "status": { "isUsed": false, "isPlaceholder": false }, "headers": [ { "name": "Authorization", "type": "string", "required": true, "description": "Bearer token" } ], "params": [ { "name": "id", "type": "number", "required": true, "description": "快递记录ID" }, { "name": "name", "type": "string", "required": false, "description": "快递名称" }, { "name": "platform", "type": "string", "required": false, "description": "平台标识(可选)" } ], "response": [] } ] }