已被代码路由取代:路径或字段和代码不一致,以代码路由条目为准。 见:GET /api/v1/products、GET /api/v1/packages、GET /api/v1/catalog-images
API REFERENCE 9.1.1.1LOGICAL-PROD:API-PROD-11
网页选品、员工搜索/扫码及顾客展示读取SP-REQ-DOC-AUDIT-20261011-R2-S1
逻辑能力,正式HTTP/owner/字段/代理未签收
契约状态:契约未定义 · 待签收实现状态:实现证据待补验证状态:仅来源核对真实接口验收:真实接口未验收
待签收
HTTP 路径未定义LOCAL MOCK ONLYi
完整字段契约尚待签收
来源尚未提供完整可生成样例的 HTTP 契约。保留已记录的方法、路径、业务说明及待补项,不从交互样稿补造字段或错误码。
02请求头 0 个字段
来源没有可展开的字段定义。完整约束可在「来源与状态」查看。
03请求参数 字段待签收
来源中的请求说明 · 字段类型待签收
待核;不为填目录发明DTO/参数
| API-PROD-11 | 网页选品、员工搜索/扫码及顾客展示读取 | 当前上下文/渠道、菜单/查询/当前条码、本店当前可售原因 | 按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计 | D57/D58/D61、B13—B15/B22 |
来源没有可展开的字段定义。完整约束可在「来源与状态」查看。
04响应参数
来源中的响应说明 · 字段类型待签收
待核;不为填目录发明DTO/参数
| API-PROD-11 | 网页选品、员工搜索/扫码及顾客展示读取 | 当前上下文/渠道、菜单/查询/当前条码、本店当前可售原因 | 按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计 | D57/D58/D61、B13—B15/B22 |
来源没有可展开的字段定义。完整约束可在「来源与状态」查看。
05错误码 沿用来源定义
来源没有完整错误响应定义,保留待补;Mock 场景不补造正式错误码。
06来源与状态
契约状态:契约未定义 · 待签收实现状态:实现证据待补验证状态:仅来源核对真实接口验收:真实接口未验收
sourceIds
src-2c755b02a7a19e1f · src-976de1a1a5a80036 · src-c6a160e4b575c0a4 · src-f398a88975f3fa31 · src-e55a60d6f258df35requirementRefs
D57/D58/D61、B13—B15/B22sourceVersion
SP-REQ-DOC-AUDIT-20261011-R2-S1sourceCommit
null来源文件与 SHA · 5 份
- 资料/downloads-0/SmartPool商品需求与三端原型-20261007-r1/原始资料/reviews/lowfi-r2-d131/inputs/接口与数据关系评审草案-实物商品-r3.md
2c00be69ca98069b694554944649e054acee57c1530b173bb6f777462b151c83original_requirement · parser_scanned - 资料/downloads-0/SmartPool商品需求与三端原型-20261007-r1/原始资料/接口与数据关系评审草案-实物商品-r3.md
2c00be69ca98069b694554944649e054acee57c1530b173bb6f777462b151c83original_requirement · parser_scanned - 资料/downloads-0/SmartPool商品需求与三端原型-20261007-r1/可移动阅读版/reviews/lowfi-r2-d131/inputs/接口与数据关系评审草案-实物商品-r3.md
af66ff88d2b4e8227e2fe06905bfb11f2782eb1177223a31f7f993a2f3a5e51foriginal_requirement · parser_scanned - 资料/downloads-0/SmartPool商品需求与三端原型-20261007-r1/可移动阅读版/接口与数据关系评审草案-实物商品-r3.md
09ac6a64b8d69582c31b93481a26132c9cc402693f879ef14f23e3bb00cd3676original_requirement · parser_scanned - 资料/previous-audit/S1-卡片与接口增量/接口分类唯一注册表S1.json
fab228aa2be9f10abdd6ca47672508fd6a6216b04434b463896b0cab8fabeb30prior_audit · parser_scanned
本接口的来源差异 · 1 项
- 旧条目已被代码路由取代(143 条)
这些旧条目在后端代码里能找到对应路由,但路径(/candidate/v0.5/…、/api/platform/… 或没写路径)、字段名、版本号字段或错误码和代码不一致。
旧条目保留,标“已被代码路由取代”,条目页里链接到对应的代码路由条目;开发以代码路由条目为准。
DIFF-CODE-ROUTES-SUPERSEDED · 按代码更新 · SP-API-CODE-ROUTES-20261106-r1
查看原始契约、引用与状态记录
{
"contract": {
"parameters": [],
"requestBody": null,
"responses": {},
"security": [],
"sourceExtensions": {},
"documentation": [
{
"sourceId": "src-2c755b02a7a19e1f",
"inputOutput": "待核;不为填目录发明DTO/参数",
"constraints": ""
},
{
"sourceId": "src-976de1a1a5a80036",
"line": 32,
"section": "候选逻辑操作及输入输出",
"tableHeaders": [
"操作ID",
"业务操作",
"候选必要输入/输出",
"核心校验/结果",
"依据"
],
"tableCells": [
"API-PROD-11",
"网页选品、员工搜索/扫码及顾客展示读取",
"当前上下文/渠道、菜单/查询/当前条码、本店当前可售原因",
"按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计",
"D57/D58/D61、B13—B15/B22"
],
"sourceText": "| API-PROD-11 | 网页选品、员工搜索/扫码及顾客展示读取 | 当前上下文/渠道、菜单/查询/当前条码、本店当前可售原因 | 按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计 | D57/D58/D61、B13—B15/B22 |",
"definitionState": "原文方向,非正式字段类型签收"
},
{
"sourceId": "src-c6a160e4b575c0a4",
"line": 32,
"section": "候选逻辑操作及输入输出",
"tableHeaders": [
"操作ID",
"业务操作",
"候选必要输入/输出",
"核心校验/结果",
"依据"
],
"tableCells": [
"API-PROD-11",
"网页选品、员工搜索/扫码及顾客展示读取",
"当前上下文/渠道、菜单/查询/当前条码、本店当前可售原因",
"按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计",
"D57/D58/D61、B13—B15/B22"
],
"sourceText": "| API-PROD-11 | 网页选品、员工搜索/扫码及顾客展示读取 | 当前上下文/渠道、菜单/查询/当前条码、本店当前可售原因 | 按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计 | D57/D58/D61、B13—B15/B22 |",
"definitionState": "原文方向,非正式字段类型签收"
},
{
"sourceId": "src-f398a88975f3fa31",
"line": 32,
"section": "候选逻辑操作及输入输出",
"tableHeaders": [
"操作ID",
"业务操作",
"候选必要输入/输出",
"核心校验/结果",
"依据"
],
"tableCells": [
"API-PROD-11",
"网页选品、员工搜索/扫码及顾客展示读取",
"当前上下文/渠道、菜单/查询/当前条码、本店当前可售原因",
"按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计",
"D57/D58/D61、B13—B15/B22"
],
"sourceText": "| API-PROD-11 | 网页选品、员工搜索/扫码及顾客展示读取 | 当前上下文/渠道、菜单/查询/当前条码、本店当前可售原因 | 按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计 | D57/D58/D61、B13—B15/B22 |",
"definitionState": "原文方向,非正式字段类型签收"
},
{
"sourceId": "src-e55a60d6f258df35",
"line": 32,
"section": "候选逻辑操作及输入输出",
"tableHeaders": [
"操作ID",
"业务操作",
"候选必要输入/输出",
"核心校验/结果",
"依据"
],
"tableCells": [
"API-PROD-11",
"网页选品、员工搜索/扫码及顾客展示读取",
"当前上下文/渠道、菜单/查询/当前条码、本店当前可售原因",
"按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计",
"D57/D58/D61、B13—B15/B22"
],
"sourceText": "| API-PROD-11 | 网页选品、员工搜索/扫码及顾客展示读取 | 当前上下文/渠道、菜单/查询/当前条码、本店当前可售原因 | 按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计 | D57/D58/D61、B13—B15/B22 |",
"definitionState": "原文方向,非正式字段类型签收"
}
],
"schemaState": "undefined_pending_signoff"
},
"status": {
"contract": "undefined_pending_signoff",
"implementation": "not_evidenced",
"verification": "source_only",
"realApiAcceptance": "not_verified",
"productionVerified": false,
"note": "源码/原型/文档证据分开;本轮没有真实HTTP、DB、短信、资金或备案验证"
},
"provenance": {
"sourceIds": [
"src-2c755b02a7a19e1f",
"src-976de1a1a5a80036",
"src-c6a160e4b575c0a4",
"src-f398a88975f3fa31",
"src-e55a60d6f258df35"
],
"requirementRefs": [
"D57/D58/D61、B13—B15/B22"
],
"cardRefs": [],
"pageRefs": [],
"codeEvidence": [],
"testEvidence": [],
"sourceVersion": "SP-REQ-DOC-AUDIT-20261011-R2-S1",
"sourceCommit": null,
"sourcePointer": null,
"traceIds": [
"PROD-B04",
"PROD-B06",
"PROD-B12",
"PROD-B13",
"PROD-B14",
"PROD-B21",
"PROD-B22",
"PROD-D132"
]
},
"diagnostics": {
"transport": "memory-only",
"networkEnabled": false,
"persistence": "none",
"doesNotInvokeOriginalHandler": true,
"businessRulesFullySimulated": false,
"note": "诊断仅依据文档schema生成合成数据;不是原接口执行回执"
},
"businessRules": [
{
"statement": "刷新和离线边界:进入、刷新和最终提交读取本店当前资料;首期网页离线不提交正式订单或库存变更,保留当前草稿待在线复核。",
"sourceId": "src-2c755b02a7a19e1f",
"historicalBoundary": "受最新R3离线及S2退款决定替换部分,参见差异"
},
{
"statement": "品牌、门店切换与旧页面结果:商品草稿/购物车绑定原品牌门店,不跨范围携带;旧请求结果不得写进新上下文,正式订单留原门店。",
"sourceId": "src-2c755b02a7a19e1f",
"historicalBoundary": "受最新R3离线及S2退款决定替换部分,参见差异"
},
{
"statement": "展示与可售判断顺序:依次核对上下文权限→本店已复制→渠道上架→本店商品/规格状态→价格→人工沽清→库存数量;首要原因按此顺序,可查看其他原因。",
"sourceId": "src-2c755b02a7a19e1f",
"historicalBoundary": "受最新R3离线及S2退款决定替换部分,参见差异"
},
{
"statement": "必填及空值:名称、至少一个规格、规格单位、一个末级基础分类必填;图片、描述、条码可空,价格可暂未设置。",
"sourceId": "src-2c755b02a7a19e1f",
"historicalBoundary": "受最新R3离线及S2退款决定替换部分,参见差异"
},
{
"statement": "总部、门店管理、收银分别呈现;规则和合同共用",
"sourceId": "src-2c755b02a7a19e1f",
"historicalBoundary": "受最新R3离线及S2退款决定替换部分,参见差异"
},
{
"statement": "条码校验与复用:条码按文本保留前导0;总部品牌内唯一对应来源规格、本店当前码唯一对应本店规格;历史旧码复用/条码交换本期后移。",
"sourceId": "src-2c755b02a7a19e1f",
"historicalBoundary": "受最新R3离线及S2退款决定替换部分,参见差异"
},
{
"statement": "空菜单分类与重复加入:空分类后台保留便于编辑,销售端隐藏;同一商品在同一分类只保留一个位置。",
"sourceId": "src-2c755b02a7a19e1f",
"historicalBoundary": "受最新R3离线及S2退款决定替换部分,参见差异"
},
{
"statement": "顾客菜单之外的链接:顾客端商品须在当前门店菜单中且满足该端展示/可售条件;直链不能绕过菜单、下架或停用。",
"sourceId": "src-2c755b02a7a19e1f",
"historicalBoundary": "受最新R3离线及S2退款决定替换部分,参见差异"
},
{
"statement": "按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计",
"sourceId": "src-c6a160e4b575c0a4"
}
],
"dataReferences": [
"HQ_PRODUCT/STORE_SKU 逻辑候选",
"HQ_SKU/STORE_SKU.barcode 文本 逻辑候选",
"MENU_CATEGORY/MENU_POSITION 逻辑候选",
"MENU_POSITION/STORE_PRODUCT 逻辑候选",
"共享业务基线;实际库边界待核",
"原品牌门店归属/请求上下文 逻辑候选",
"渠道/商品状态/SKU状态/价格/沽清 逻辑候选",
"草稿/SALE_SNAPSHOT/OPERATION_RESULT 逻辑候选"
],
"issues": [
"已被代码路由取代:路径或字段和代码不一致,以代码路由条目为准。",
"顾客端仅当前菜单展示/可售范围;本期不新增顾客交易流程,不把此目录索引授为直接内部HTTP调用权"
]
}