| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| appkey | string | 是 | 无 | 开发者凭据;支持现有 Query、Header 和 Bearer,多处值须一致。 |
| 字段 | 类型 | 说明 |
|---|---|---|
| DataStatus.RequestParameter | string | 真实、可读的业务请求参数;无业务参数时为空,不包含凭据。 |
| DataStatus.StatusCode | integer | 接口返回状态码。 |
| DataStatus.StatusDescription | string | 接口返回状态说明。 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间。 |
| DataStatus.DataTotalCount | integer | 本次返回问卷数量。 |
| Data | array | 包含问卷列表、详情、答案提交、单条结果和历史测试列表五条关联接口。结果及历史列表仅对创建记录的 AppKey 可见,即使 userId 相同也不会跨应用共享。评分用于职业与发展参考,不提供医疗诊断;维度资料 Dimensions 为对象数组。 |
| Data.QuestionnaireCode | string | 问卷编码,用于关联问卷详情、测试提交及测试记录查询。 |
| Data.QuestionnaireName | string | 问卷中文名称。 |
| Data.QuestionnaireNameEn | string | 问卷英文名称。 |
| Data.Description | string | 问卷简介。 |
| Data.QuestionCount | integer | 该问卷的题目数量,用于展示作答规模;不是测评维度数量。 |
| Data.Dimensions | array | 问卷测评维度资料,包含维度编码、名称与说明,用于展示评估主题。 |
| Data.Source | string | 问卷来源或参考体系。 |
| Data.UseCount | integer | 问卷使用次数资料,不代表问卷效度、信度或用户测评得分。 |
| 业务状态码 | 业务状态码解释 | 备注 |
|---|---|---|
| 100 | 成功 | HTTP 200 |
| 501 | 参数错误 | HTTP 400 |
| 900 | 处理失败 | HTTP 500 |
| 502 | 频率受限 | HTTP 429 |
| 503 | 无权限或过期 | HTTP 403 |
| 504 | 凭据错误 | HTTP 401 |
| 505 | 额度不可用 | HTTP 403 |