[查询] 用户测试历史

用户测试历史。包含问卷列表、详情、答案提交、单条结果和历史测试列表五条关联接口。结果及历史列表仅对创建记录的 AppKey 可见，即使 userId 相同也不会跨应用共享。评分用于职业与发展参考，不提供医疗诊断；维度资料 Dimensions 为对象数组。

当前接口契约

接口详情：https://www.gugudata.com/api/details/psychology-questionnaires

请求参数

参数	类型	必填	默认值	说明
appkey	string	是	无	咕咕数据开发者中心分配的 APPKEY。
filter	string	是	无	userId 必填，可通过 AND 组合 questionnaireCode；仅查询当前 AppKey 创建的记录。
pageSize	integer	否	无	每页数量，默认 20，最大 100
pageToken	integer	否	无	页码，默认 1

正常响应

HTTP 200，application/json。

字段	类型	说明
DataStatus	object
DataStatus.RequestParameter	string	真实、可读的业务请求参数；无业务参数时为空，不包含凭据。
DataStatus.StatusCode	integer	接口返回状态码。
DataStatus.StatusDescription	string	接口返回状态说明。
DataStatus.ResponseDateTime	string	接口数据返回时间。
DataStatus.DataTotalCount	integer	当前 AppKey 下符合过滤条件的历史记录总数。
Data	object[]	接口返回的业务数据。

业务状态说明

业务状态码	业务状态码解释	备注
501	参数错误	HTTP 400
900	处理失败	HTTP 500

历史响应示例说明

保留的历史列表响应与当前字段定义不完全一致。本轮未读取用户心理测试记录来替换该示例；接入请以当前响应字段说明为准。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。

Bodyapplication/json

示例

{
  "DataStatus": {
    "StatusCode": 100,
    "StatusDescription": "OK",
    "ResponseDateTime": "2026-01-01 00:00:00",
    "DataTotalCount": 1
  },
  "Data": {}
}

🟠400参数、答案或记录归属不符合要求，业务码 501。

🟠401鉴权失败。缺少 appkey 或 appkey 无效。

🟠403无权限访问。订单到期、权限不足或接口额度不可用。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。

🔴500处理或配置不可用，业务码 900；不返回内部异常。

🔴502上游依赖错误。上游依赖服务不可用或返回异常。

当前接口契约#

请求参数#

正常响应#

业务状态说明#

历史响应示例说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应

业务状态说明

历史响应示例说明