已被代码路由取代:路径或字段和代码不一致,以代码路由条目为准。 见: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 ONLYi
候选/本地契约 · 诊断仅为模拟
以下参数沿用内容源,示例数据按 schema 合成。接入诊断在浏览器内运行,模拟结果不表示真实接口已实现或已验收。
02请求头 1 个字段
| 字段名 | 类型 | 必填 | 说明与约束 | 示例值 |
|---|---|---|---|---|
Content-Type | string | 必填 | 来自请求体 media type枚举:"application/json" | "application/json" |
03请求参数 Body
| 字段名 | 类型 | 必填 | 说明与约束 | 示例值 |
|---|---|---|---|---|
scenario | oneOf | 必填 | 来源未提供说明 | 1 |
04响应参数
现有本地Mock合成样例
| 字段名 | 类型 | 必填 | 说明与约束 | 示例值 |
|---|---|---|---|---|
mock | boolean | 可省略 | 来源未提供说明 | true |
persistence | string | 可省略 | 来源未提供说明 | "none" |
fixture | string | 可省略 | 来源未提供说明 | "每次重新初始化的演示数据,不读取当前浏览器或生产数据" |
ok | boolean | 可省略 | 来源未提供说明 | true |
data | object | 可省略 | 来源未提供说明 | { … } |
05错误码 沿用来源定义
| HTTP 状态 | 来源业务码 | 来源说明 |
|---|---|---|
400 | INVALID_REQUESTINVALID_JSON | INVALID_REQUEST/INVALID_JSON |
403 | FORBIDDEN | FORBIDDEN |
413 | REQUEST_TOO_LARGE | REQUEST_TOO_LARGE |
06来源与状态
契约状态:仅本地 Mock实现状态:本地 Mock 源码已核验证状态:仅来源核对真实接口验收:真实接口未验收
sourceIds
src-bc37c19c00051301 · src-5494c0ac88b983e0 · src-60c07275b23d0731 · src-6c951cfd95dfbcb9 · src-642917f93681d603 · src-508270cd7c1cfec4requirementRefs
sourceVersion
PR83 local MocksourceCommit
b62495c4e787c3d5cfe3355d4126e3f25dd3cd54来源文件与 SHA · 8 份
- app/api/mock/platform-login/route.test.ts
ea9266e07c085369c2d493e118acef6e7875d0d083a6028ee332a72cc1e6525esource_test · parser_scanned - app/api/mock/platform-overview/route.ts
1573868e1ff616986f66b34376073b0f1007733a5bde03303d70e93164975516source_route · parser_scanned - docs/REVIEW-API-EXAMPLES-20260924.md
5a5d033e26336ff39514eb2da8f734785e3e2539a560f04dd97aab232667ec4capi_document · parser_scanned - features/integration/api-catalog/mock-examples.json
6e0fe522f9c0116c844b37e82e4f18a67c6b0532a0ad39d21fc99e77b5a68e55api_document · parser_scanned - features/review/OverviewApiDocument.test.tsx
484232ccd600c3b0279ffb62805f67bd6078df985f1b27cec4e51dfba1092bedsource_test · parser_scanned - features/review/OverviewApiDocument.tsx
c8c84afbd43f3dca100571f45085711aace8e42b0b716c2a0c4edcf7e68b3e46source_model · parser_scanned - features/review/overview-enums.ts
16f879e63141fc60932375ddd59fef8ebf6b9045de11871d0059e2b3bfa99940source_model · parser_scanned - features/review/overview-mock.ts
24976d69ddb0b5e630749a810ee176738bf19617aaf8dbe18485a9430973b449source_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响应形状仅样例,完整逐场景判别联合待核;错误码保留原协议,不造统一响应"
]
}