职业与发展心理测评问卷 API 接口
接口详情官网地址: https://www.gugudata.com/api/details/psychology-questionnaires
职业与发展心理测评问卷 API 专业心理测评与职业发展心理测评，心理测评、原创题库、职业发展、高考心理等关键词场景常会用到，适合用于字典与基础库查询、教育与行业数据整合与筛选条件补全与业务检索等业务场景，方便开发者直接在应用、脚本或数据流程中接入。
1. 产品功能
- 共 34 份问卷：9 份历史兼容参考量表 + 25 份原创版权安全题库；
- 原创题库覆盖职业发展、大学毕业过渡与高考心理三大场景；
- 支持总分与维度分计算，提交后自动返回解释与建议；
- 保持查询问卷、提交答案、查询结果、历史查询全链路兼容；
- 支持完整题号校验，防止缺题、错题号导致评分偏差；
- 遵循 Google AIP 风格设计，接口结构稳定且易集成；
2. API 文档
接口地址: https://api.gugudata.com/v1/psychology/questionnaires
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/v1/psychology/questionnaires?appkey=YOUR_APPKEY
数据预览: https://www.gugudata.com/preview/psychology-questionnaires
接口测试: https://api.gugudata.com/v1/psychology/questionnaires/demo
3. 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付费后获取的 APPKEY |
4. 返回参数
| 参数名 | 参数类型 | 备注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回状态码，100 为成功 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | int | 问卷总数量（当前版本 34：历史兼容 9 份 + 原创 25 份） |
| Data[].QuestionnaireCode | string | 问卷编码，如 HOLLAND_SDS |
| Data[].QuestionnaireName | string | 问卷名称 |
| Data[].QuestionnaireNameEn | string | 问卷英文名称 |
| Data[].Description | string | 问卷描述及理论基础说明 |
| Data[].QuestionCount | int | 题目数量 |
| Data[].Dimensions | array | 测试维度列表 |
| Data[].Dimensions[].DimensionCode | string | 维度代码 |
| Data[].Dimensions[].DimensionName | string | 维度名称 |
| Data[].Dimensions[].Description | string | 维度描述 |
| Data[].Source | string | 问卷来源或理论基础 |
| Data[].UseCount | int | 使用次数统计 |
5. 错误码说明
| 状态码 | 错误说明 | 备注 |
|---|---|---|
| 100 | 正常返回 | - |
| 501 | 参数错误 | 检查必填参数、问卷编码、答案格式（answers 必须为对象且包含全部题号） |
| 502 | 请求频率受限 | 网关/CDN 可能返回 429 或业务状态码 502 |
| 503 | 账号欠费或订单过期 | 请前往开发者中心检查订单有效期 |
| 504 | APPKEY 错误 | 请检查传递的 APPKEY 是否正确 |
| 900 | 服务器内部错误 | 请联系技术支持 |
6. 适用场景
- 适合用于字典与基础库查询，快速补齐产品侧需要的 职业与发展心理测评问卷 数据能力。
- 适合用于教育与行业数据整合，减少手工整理、清洗与重复开发成本。
- 适合用于筛选条件补全与业务检索，将接口结果直接接入后台系统、数据任务或内容处理流程。
7. 相关接口
- 相关接口：获取问卷详情（GET），获取指定问卷的详细信息和所有题目。
- 相关接口：提交测试答案（POST），提交用户答案，自动计算得分并生成测评结果。
- 相关接口：查询测试结果（GET），根据测试ID查询测试结果详情。
- 相关接口：用户测试历史（GET），查询用户的历史测试记录列表，支持按问卷类型过滤。