SSmartPool开放平台

已被代码路由取代:路径或字段和代码不一致,以代码路由条目为准。 见:GET /api/v1/products、GET /api/v1/packages、GET /api/v1/catalog-images

API REFERENCE 8.1.1.1LOGICAL-PROD:API-PROD-11

网页选品、员工搜索/扫码及顾客展示读取SP-REQ-DOC-AUDIT-20261011-R2-S1

逻辑能力,正式HTTP/owner/字段/代理未签收

契约状态:契约未定义 · 待签收实现状态:实现证据待补验证状态:仅来源核对真实接口验收:真实接口未验收
待签收HTTP 路径未定义LOCAL MOCK ONLY
i
完整字段契约尚待签收

来源尚未提供完整可生成样例的 HTTP 契约。保留已记录的方法、路径、业务说明及待补项,不从交互样稿补造字段或错误码。

01接口说明

业务端 / 模块顾客点单小程序 / 菜单
请求格式来源未定义
鉴权与权限来源未定义
技术服务归属(元信息)归属待核
菜单 · 操作与权限说明 SP-API-PAGE-REVIEW-20261015-r2

已核对页面源码、菜单登记和已有契约。下面分别列出候选契约、本地模型及尚待签收的部分;目录可见不授予调用权。

读取边界
当前小程序顾客会话及已授权本人订单/会员关系,与H5独立。
写入边界
本人授权及当前订单状态、版本和期限;支付权威结果不由本地按钮确认为成功。
数据范围
小程序会话、本人、门店与原订单;不得复用H5会话。
页面主动作
查看购物车。主动作来自页面登记;导航、筛选、预览和禁用占位不因此成为HTTP接口。命令条目只证明本地源码存在;候选关联沿用原实现状态。
页面对象
CatalogItem / InventoryState

本页未从源码提取新的统一权限键,沿用上方身份与范围守卫。页面范围守卫与接口候选权限分别核对;参与键不代表必须同时持有,也不由目录显示授予。

当前编号 / 操作来源与实现边界原契约权限说明
8.1.1.1 网页选品、员工搜索/扫码及顾客展示读取LOGICAL-PROD:API-PROD-11原候选/需求契约 · 沿用原实现状态not_evidenced · 真实接口未验收未登记独立HTTP权限键,按页面源码守卫核对;不得从角色名推导授权。
源码与权限依据
  • navigation/customer-mini-pages.ts:8当前菜单页面、对象类型与主动作登记
  • features/customer/CustomerPage.tsx:78pageKey === "CUST-02"
  • domain/customer-surface.ts:11原型权限来源,非服务端验收
  • features/customer/selectors.ts:3原型权限来源,非服务端验收

逻辑能力,正式HTTP/owner/字段/代理未签收目录引用不授予调用权限。

来源业务约束
  • 刷新和离线边界:进入、刷新和最终提交读取本店当前资料;首期网页离线不提交正式订单或库存变更,保留当前草稿待在线复核。受最新R3离线及S2退款决定替换部分,参见差异
  • 品牌、门店切换与旧页面结果:商品草稿/购物车绑定原品牌门店,不跨范围携带;旧请求结果不得写进新上下文,正式订单留原门店。受最新R3离线及S2退款决定替换部分,参见差异
  • 展示与可售判断顺序:依次核对上下文权限→本店已复制→渠道上架→本店商品/规格状态→价格→人工沽清→库存数量;首要原因按此顺序,可查看其他原因。受最新R3离线及S2退款决定替换部分,参见差异
  • 必填及空值:名称、至少一个规格、规格单位、一个末级基础分类必填;图片、描述、条码可空,价格可暂未设置。受最新R3离线及S2退款决定替换部分,参见差异
  • 总部、门店管理、收银分别呈现;规则和合同共用受最新R3离线及S2退款决定替换部分,参见差异
  • 条码校验与复用:条码按文本保留前导0;总部品牌内唯一对应来源规格、本店当前码唯一对应本店规格;历史旧码复用/条码交换本期后移。受最新R3离线及S2退款决定替换部分,参见差异
  • 空菜单分类与重复加入:空分类后台保留便于编辑,销售端隐藏;同一商品在同一分类只保留一个位置。受最新R3离线及S2退款决定替换部分,参见差异
  • 顾客菜单之外的链接:顾客端商品须在当前门店菜单中且满足该端展示/可售条件;直链不能绕过菜单、下架或停用。受最新R3离线及S2退款决定替换部分,参见差异
  • 按B14顺序;员工可查菜单外本店已上架合格品;顾客菜单/直链约束;刷新机制待设计
  • 已被代码路由取代:路径或字段和代码不一致,以代码路由条目为准。
  • 顾客端仅当前菜单展示/可售范围;本期不新增顾客交易流程,不把此目录索引授为直接内部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来源与状态

契约状态:契约未定义 · 待签收实现状态:实现证据待补验证状态:仅来源核对真实接口验收:真实接口未验收
sourceIdssrc-2c755b02a7a19e1f · src-976de1a1a5a80036 · src-c6a160e4b575c0a4 · src-f398a88975f3fa31 · src-e55a60d6f258df35
requirementRefsD57/D58/D61、B13—B15/B22
sourceVersionSP-REQ-DOC-AUDIT-20261011-R2-S1
sourceCommitnull
来源文件与 SHA · 5 份
  • 资料/downloads-0/SmartPool商品需求与三端原型-20261007-r1/原始资料/reviews/lowfi-r2-d131/inputs/接口与数据关系评审草案-实物商品-r3.md2c00be69ca98069b694554944649e054acee57c1530b173bb6f777462b151c83original_requirement · parser_scanned
  • 资料/downloads-0/SmartPool商品需求与三端原型-20261007-r1/原始资料/接口与数据关系评审草案-实物商品-r3.md2c00be69ca98069b694554944649e054acee57c1530b173bb6f777462b151c83original_requirement · parser_scanned
  • 资料/downloads-0/SmartPool商品需求与三端原型-20261007-r1/可移动阅读版/reviews/lowfi-r2-d131/inputs/接口与数据关系评审草案-实物商品-r3.mdaf66ff88d2b4e8227e2fe06905bfb11f2782eb1177223a31f7f993a2f3a5e51foriginal_requirement · parser_scanned
  • 资料/downloads-0/SmartPool商品需求与三端原型-20261007-r1/可移动阅读版/接口与数据关系评审草案-实物商品-r3.md09ac6a64b8d69582c31b93481a26132c9cc402693f879ef14f23e3bb00cd3676original_requirement · parser_scanned
  • 资料/previous-audit/S1-卡片与接口增量/接口分类唯一注册表S1.jsonfab228aa2be9f10abdd6ca47672508fd6a6216b04434b463896b0cab8fabeb30prior_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调用权"
  ]
}
SmartPool 接口文档PHP 示例 · 内存 Mock · 来源状态保留
LOCAL MOCK

接入诊断

i
全部在浏览器内模拟

参数只保留在当前面板内存中,关闭后清空。不发送接口请求;请使用合成参数。

待签收HTTP 路径尚未定义
来源尚无完整可用的合成请求示例,无法运行该记录的诊断。来源、需求和待补状态已保留。

诊断结果

等待运行
⌘准备就绪

选择场景,点击「运行 Mock」查看合成响应。