SSmartPool开放平台

已被代码路由取代:路径或字段和代码不一致,以代码路由条目为准。 见:POST /api/v1/platform/overview

API REFERENCE 1.1.1.1mock.platform-overview

平台概览统计PR83 local Mock

本地 Mock 已实现;固定合成种子,不读写真实数据库,不表示该接口已在生产部署。

契约状态:仅本地 Mock实现状态:本地 Mock 源码已核验证状态:仅来源核对真实接口验收:真实接口未验收
POST/api/mock/platform-overviewLOCAL MOCK ONLY
i
候选/本地契约 · 诊断仅为模拟

以下参数沿用内容源,示例数据按 schema 合成。接入诊断在浏览器内运行,模拟结果不表示真实接口已实现或已验收。

01接口说明

业务端 / 模块平台端 / 工作台
请求格式application/json
鉴权与权限来源未定义
技术服务归属(元信息)归属待核
平台概览 · 操作与权限说明 SP-API-PAGE-REVIEW-20261015-r2

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

读取边界
有效平台员工及platform.read明确授权;按授权企业/门店集合过滤;独立审计另核权限。
写入边界
各动作单独核对执行权、当前对象及版本;平台元信息读取不授予文件内容或资金执行权。
数据范围
当前平台账号及明确授权的企业/品牌/门店对象;URL不扩权。
页面主动作
刷新概览。主动作来自页面登记;导航、筛选、预览和禁用占位不因此成为HTTP接口。命令条目只证明本地源码存在;候选关联沿用原实现状态。
页面对象
Enterprise / Store / ServiceCase

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

当前编号 / 操作来源与实现边界原契约权限说明
1.1.1.1 平台概览统计mock.platform-overview既有本地Mock · 真实接口未验收local_mock_source_verified · 真实接口未验收未登记独立HTTP权限键,按页面源码守卫核对;不得从角色名推导授权。
1.1.1.2 查询平台概览汇总doc-http:POST--api-platform-overview-summary-10e0e6af原候选/需求契约 · 沿用原实现状态source_contract_only · 真实接口未验收未登记独立HTTP权限键,按页面源码守卫核对;不得从角色名推导授权。
1.1.1.3 查询平台概览明细doc-http:POST--api-platform-overview-details-b9c2277f原候选/需求契约 · 沿用原实现状态source_contract_only · 真实接口未验收未登记独立HTTP权限键,按页面源码守卫核对;不得从角色名推导授权。
源码与权限依据
  • navigation/platform-pages.ts:42当前菜单页面、对象类型与主动作登记
  • features/platform/PlatformPage.tsx:249case PLAT-01
  • features/platform/PlatformRoles.tsx:21["PLAT-01", "PLAT-09", "PLAT-30"].includes(key)
  • features/platform/selectors.ts:49原型权限来源,非服务端验收

本地 Mock 已实现;固定合成种子,不读写真实数据库,不表示该接口已在生产部署。目录引用不授予调用权限。

  • 已被代码路由取代:路径或字段和代码不一致,以代码路由条目为准。
  • 输入schema依据固定validator;跨字段和领域权限规则仍由原文约束。200响应形状仅样例,完整逐场景判别联合待核;错误码保留原协议,不造统一响应

02请求头 1 个字段

示例值为来源示例或按来源 schema 合成;子字段的必填约束在父对象出现时适用。
字段名类型必填说明与约束示例值
Content-Typestring必填来自请求体 media type枚举:"application/json""application/json"

03请求参数 Body

示例值为来源示例或按来源 schema 合成;子字段的必填约束在父对象出现时适用。
字段名类型必填说明与约束示例值
scenariooneOf必填来源未提供说明1

04响应参数

现有本地Mock合成样例

示例值为来源示例或按来源 schema 合成;子字段的必填约束在父对象出现时适用。
字段名类型必填说明与约束示例值
mockboolean可省略来源未提供说明true
persistencestring可省略来源未提供说明"none"
fixturestring可省略来源未提供说明"每次重新初始化的演示数据,不读取当前浏览器或生产数据"
okboolean可省略来源未提供说明true
dataobject可省略来源未提供说明{ … }

05错误码 沿用来源定义

HTTP 状态来源业务码来源说明
400INVALID_REQUESTINVALID_JSONINVALID_REQUEST/INVALID_JSON
403FORBIDDENFORBIDDEN
413REQUEST_TOO_LARGEREQUEST_TOO_LARGE

06来源与状态

契约状态:仅本地 Mock实现状态:本地 Mock 源码已核验证状态:仅来源核对真实接口验收:真实接口未验收
sourceIdssrc-bc37c19c00051301 · src-5494c0ac88b983e0 · src-60c07275b23d0731 · src-6c951cfd95dfbcb9 · src-642917f93681d603 · src-508270cd7c1cfec4
requirementRefs
sourceVersionPR83 local Mock
sourceCommitb62495c4e787c3d5cfe3355d4126e3f25dd3cd54
来源文件与 SHA · 8 份
  • app/api/mock/platform-login/route.test.tsea9266e07c085369c2d493e118acef6e7875d0d083a6028ee332a72cc1e6525esource_test · parser_scanned
  • app/api/mock/platform-overview/route.ts1573868e1ff616986f66b34376073b0f1007733a5bde03303d70e93164975516source_route · parser_scanned
  • docs/REVIEW-API-EXAMPLES-20260924.md5a5d033e26336ff39514eb2da8f734785e3e2539a560f04dd97aab232667ec4capi_document · parser_scanned
  • features/integration/api-catalog/mock-examples.json6e0fe522f9c0116c844b37e82e4f18a67c6b0532a0ad39d21fc99e77b5a68e55api_document · parser_scanned
  • features/review/OverviewApiDocument.test.tsx484232ccd600c3b0279ffb62805f67bd6078df985f1b27cec4e51dfba1092bedsource_test · parser_scanned
  • features/review/OverviewApiDocument.tsxc8c84afbd43f3dca100571f45085711aace8e42b0b716c2a0c4edcf7e68b3e46source_model · parser_scanned
  • features/review/overview-enums.ts16f879e63141fc60932375ddd59fef8ebf6b9045de11871d0059e2b3bfa99940source_model · parser_scanned
  • features/review/overview-mock.ts24976d69ddb0b5e630749a810ee176738bf19617aaf8dbe18485a9430973b449source_model · parser_scanned
本接口的来源差异 · 2 项
  • Mock输入与200样例覆盖不同

    六条输入按固定validator整理;品牌分页各page/list及命令结果有不同返回形状,现有200例子不是完整判别联合。

    区分validator-derived input与example-only response;跨字段/领域权限、全部响应联合留在验收清单,不标完整运行模拟。

    DIFF-MOCK-RESPONSE-COVERAGE · RETAINED_PENDING_SIGNOFF_OR_EVIDENCE
  • 旧条目已被代码路由取代(143 条)

    这些旧条目在后端代码里能找到对应路由,但路径(/candidate/v0.5/…、/api/platform/… 或没写路径)、字段名、版本号字段或错误码和代码不一致。

    旧条目保留,标“已被代码路由取代”,条目页里链接到对应的代码路由条目;开发以代码路由条目为准。

    DIFF-CODE-ROUTES-SUPERSEDED · 按代码更新 · SP-API-CODE-ROUTES-20261106-r1
查看原始契约、引用与状态记录
{
  "contract": {
    "parameters": [],
    "requestBody": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/LocalExample_mock-platform-overview-329709d7Input"
          }
        }
      }
    },
    "responses": {
      "200": {
        "description": "现有本地Mock合成样例",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/LocalExample_mock-platform-overview-329709d7Response"
            }
          }
        }
      },
      "400": {
        "description": "INVALID_REQUEST/INVALID_JSON",
        "x-source-status-only": true
      },
      "403": {
        "description": "FORBIDDEN",
        "x-source-status-only": true
      },
      "413": {
        "description": "REQUEST_TOO_LARGE",
        "x-source-status-only": true
      }
    },
    "security": [],
    "sourceExtensions": {
      "x-validation-notes": [
        "每次重新初始化种子,非当前浏览器或生产统计"
      ]
    },
    "documentation": [],
    "schemaState": "local_input_validator_derived; response_sample_shape_only",
    "requestNote": "scenario 为数字 1/2/3;保留原兼容字符串。"
  },
  "status": {
    "contract": "local_mock_only",
    "implementation": "local_mock_source_verified",
    "verification": "source_only",
    "realApiAcceptance": "not_verified",
    "productionVerified": false,
    "note": "源码/原型/文档证据分开;本轮没有真实HTTP、DB、短信、资金或备案验证"
  },
  "provenance": {
    "sourceIds": [
      "src-bc37c19c00051301",
      "src-5494c0ac88b983e0",
      "src-60c07275b23d0731",
      "src-6c951cfd95dfbcb9",
      "src-642917f93681d603",
      "src-508270cd7c1cfec4"
    ],
    "requirementRefs": [],
    "cardRefs": [],
    "pageRefs": [],
    "codeEvidence": [
      {
        "sourceId": "src-5494c0ac88b983e0",
        "path": "app/api/mock/platform-overview/route.ts",
        "claim": "源码存在;未真实调HTTP"
      },
      {
        "sourceId": "src-60c07275b23d0731",
        "path": "features/review/overview-mock.ts",
        "claim": "源码存在;未真实调HTTP"
      },
      {
        "sourceId": "src-6c951cfd95dfbcb9",
        "path": "features/review/overview-enums.ts",
        "claim": "源码存在;未真实调HTTP"
      },
      {
        "sourceId": "src-642917f93681d603",
        "path": "features/review/OverviewApiDocument.tsx",
        "claim": "源码存在;未真实调HTTP"
      }
    ],
    "testEvidence": [
      {
        "sourceId": "src-8f5a1e36f0d3b167",
        "path": "app/api/mock/platform-login/route.test.ts",
        "result": "NOT_RUN_THIS_TASK",
        "claim": "测试源存在;不能推断已通过"
      },
      {
        "sourceId": "src-dacc9a966fdeb739",
        "path": "features/review/OverviewApiDocument.test.tsx",
        "result": "NOT_RUN_THIS_TASK",
        "claim": "测试源存在;不能推断已通过"
      }
    ],
    "sourceVersion": "PR83 local Mock",
    "sourceCommit": "b62495c4e787c3d5cfe3355d4126e3f25dd3cd54",
    "sourcePointer": null
  },
  "diagnostics": {
    "transport": "memory-only",
    "networkEnabled": false,
    "persistence": "none",
    "doesNotInvokeOriginalHandler": true,
    "businessRulesFullySimulated": false,
    "note": "诊断仅依据文档schema生成合成数据;不是原接口执行回执"
  },
  "businessRules": [],
  "dataReferences": [],
  "issues": [
    "已被代码路由取代:路径或字段和代码不一致,以代码路由条目为准。",
    "输入schema依据固定validator;跨字段和领域权限规则仍由原文约束。200响应形状仅样例,完整逐场景判别联合待核;错误码保留原协议,不造统一响应"
  ]
}
SmartPool 接口文档PHP 示例 · 内存 Mock · 来源状态保留
LOCAL MOCK

接入诊断

i
全部在浏览器内模拟

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

POST/api/mock/platform-overview
请求头与其他参数

诊断结果

等待运行
⌘准备就绪

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