首页 / 开放能力 / AI 成熟度自测 API

AI 成熟度自测 API

10 题 · 5 维 · 30 分制的企业 AI 成熟度评测接口：提交答案即返回总分、L1-L5 等级、五维得分与最短板诊断。与官网自测页同款题库。

POST /v1/maturity v1 免费额度 · 申请制

快速开始

替换 YOUR_KEY 为你申请到的 Key，直接发起首个请求：

# 提交自测答案（异步无，秒级返回）
curl -X POST https://skyaibi.com/v1/maturity \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"answers": {"q1": 2, "q2": 1, "q3": 3, "q4": 0, "q5": 2,
                      "q6": 1, "q7": 1, "q8": 2, "q9": 1, "q10": 2}}'

# 响应
{"code": 0, "data": {
  "total": 15, "level": "L3 局部试点",
  "dims": {"strategy": 3, "data": 4, "scenario": 3,
           "platform": 2, "talent": 3},
  "weakest": "platform",
  "advice": "优先补齐平台与技术底座……"
}}

示例参数为示意，正式字段与枚举值以 OpenAPI 3.1 规范为准（下方可下载，可直接导入 Apifox / Postman）。

鉴权与调用约束

所有请求携带请求头 X-API-Key，在申请开通后由系统下发
每道题取值为 0-3 分，10 题满分 30 分；缺题将按 0 分计入并在响应中提示
限频规则：免费额度内默认 20 次/分钟，超限返回 429
可打包进企业内部的 AI 成熟度普查 / 培训前测，支持批量提交（见规范 additionalProperties）

接口清单

方法	路径	说明
POST	/v1/maturity	提交 10 题答案，返回总分/等级/五维/最短板
GET	/v1/maturity/questions	获取题库（题干、维度归属、选项分值）
GET	/v1/maturity/levels	获取 L1-L5 等级定义与建议动作

错误码

code	含义	处理建议
40001	无效 API Key	检查 X-API-Key 是否正确、是否已开通
40002	免费额度用尽	升级套餐或联系商务扩容
422	参数缺失/不合法	按错误信息中 field 字段修正请求体
429	触发限频	降低调用频率，参考 Retry-After 响应头
500	服务内部错误	稍后重试，持续失败请联系我们

规范与申请

下载 OpenAPI 3.1 规范（JSON）申请 API Key

FAQ

常见问题

AI 成熟度自测 API 的评分口径是什么？

10 道题覆盖战略与组织、数据底座、场景与价值、平台与技术、人才与文化五个维度，每题 0-3 分，总分 30 分，按区间映射 L1-L5 等级；接口同时返回最短板维度与对应建议。

可以用于企业内部批量评测吗？

可以。接口支持逐份提交，也可按 OpenAPI 规范中的批量字段一次提交多份；企业普查场景建议联系我们开具专用 Key 与更高限频。