接口说明（见闲 · 6v1）
显著声明（读前必看）
- 本站接口为自用——它首先服务于本站自己的页面，不是对外产品。
- 不承诺对外稳定性——端点、字段与错误码可能随本站需要变化，不构成契约。
- 无 API Key——不存在申请、配额或计费通道。
- 不作为公开能力接口——如需使用 6v1 的能力，请走页面上的公开入口。
本页是说明性文档，不是公开可调用契约：不含 SLA、试用配额与版本兼容承诺。
事实披露
本站不提供读取或删除作答记录的端点；提交端点无鉴权、无 API Key。
session_id 由客户端生成（≥128 bit 随机），服务端只校验、不生成；标识不可枚举。
所有响应带 Cache-Control: no-store；存在内存态限流（阈值不公开）。
端点清单
| 方法 | 路径 | 用途 | 响应状态码 |
|---|---|---|---|
GET | /api/v1/question-set/current | 题库只读副本 | 200 / 405 / 503 |
POST | /api/v1/subscriptions | 提交订阅 | 200 / 400 / 405 / 415 / 429 / 503 |
POST | /api/v1/subscriptions/confirmation | 确认订阅 | 200 / 400 / 405 / 415 / 429 / 503 |
POST | /api/v1/subscriptions/cancellation | 退订 | 200 / 400 / 405 / 415 / 429 / 503 |
POST | /api/v1/subscriptions/resends | 重新发送订阅邮件 | 200 / 400 / 405 / 415 / 429 / 503 |
POST | /api/v1/sessions | 提交一次完整作答 | 200 / 400 / 405 / 415 / 429 / 503 |
错误码闭集（7 码）
| 错误码 | HTTP 状态 | 触发条件 |
|---|---|---|
invalid_request | 400 | 请求体字段缺失、格式或取值域非法 |
unknown_field | 400 | 请求体含未声明字段（含未声明题号） |
not_found | 404 | 请求路径不存在（框架级未匹配路径） |
method_not_allowed | 405 | 该端点不支持此 HTTP 方法 |
unsupported_media_type | 415 | 请求体媒体类型不是 application/json |
rate_limited | 429 | 同一会话标识在窗口内请求过于频繁 |
unavailable | 503 | 服务暂时不可用（含数据面故障） |
字段与必填性
必填性以服务端校验为准；“必填”表示该字段缺失或为空时请求一律被拒绝。
| 对象 | 字段 | 必填 | 说明 |
|---|---|---|---|
| SubmitSessionRequest | session_id | 必填 | 客户端生成的会话标识（不可枚举）；服务端只校验、不生成 |
| SubmitSessionRequest | submitted_at | 可缺省 | 客户端提交时间；仅用于一致性比对，可缺省 |
| SubmitSessionRequest | duration_band | 必填 | 作答耗时分档（四档） |
| SubmitSessionRequest | question_set_version | 必填 | 客户端题库版本；存在性不校验，落库并标记 |
| SubmitSessionRequest | client_build | 必填 | 页面构建版本（非个人信息） |
| SubmitSessionRequest | answers | 必填 | 19 题所选项，键为 Q1..Q19，值 0..3；未声明键一律拒绝 |
| SubmitSessionRequest | result | 必填 | |
| ClientResult | d1 | 必填 | 维度 D1 得分，取值 [0,1] |
| ClientResult | d2 | 必填 | 维度 D2 得分，取值 [0,1] |
| ClientResult | d3 | 必填 | 维度 D3 得分，取值 [0,1] |
| ClientResult | d4 | 必填 | 维度 D4 得分，取值 [0,1] |
| ClientResult | d5 | 必填 | 维度 D5 得分，取值 [0,1] |
| ClientResult | total | 必填 | 总分，取值 [0,1] |
| ClientResult | grade | 必填 | 等级 1..5 |
| ClientResult | degraded | 必填 | 是否触发最短木板降级 |
| ClientResult | weakest_dims | 必填 | 最弱维（空或 ≤5 个） |
| SubmitSessionResponse | status | 必填 | 恒为 saved |
| SubmitSessionResponse | submitted_at | 必填 | 服务端首次接受的落库时间（分钟截断）；重复提交返回同一值 |
| SubscribeRequest | email | 必填 | 邮箱地址；同一邮箱重复提交不新增记录、不重复发送 |
| TokenRequest | token | 必填 | 确认或退订令牌；一次性，仅经请求体提交 |
| SubscribeResponse | status | 必填 | 固定取值：recorded 或 accepted |
| Dimension | id | 必填 | 维度标识 D1..D5 |
| Dimension | name | 必填 | 维度中文名 |
| Question | id | 必填 | 题目标识 Q1..Q19 |
| Question | dim | 必填 | 所属维度 |
| Question | text | 必填 | 题干 |
| Question | evidence | 必填 | 证据提示 |
| Question | order | 必填 | 题序 |
| ScaleOption | value | 必填 | 档位 0..3 |
| ScaleOption | label | 必填 | 档位文字 |
| QuestionSet | version | 必填 | 题库版本 |
| QuestionSet | dimensions | 必填 | |
| QuestionSet | questions | 必填 | |
| QuestionSet | scale | 必填 |
机器可读描述文件：/openapi.json（OpenAPI 3.1 最小子集；与上表同源渲染）。
不在范围内
本站当前不提供程序化能力调用相关的任何约定：不做协议化的能力发现、不做接口密钥体系、不做试用配额与 SLA。