拾棠心理测试API正式上线:心理测评能力面向合作方开放

拾棠产品团队
2026-10-13 20:39:38

心理测评正在从"一个独立的测试入口"变成"产品里的一项基础能力"。企业服务、心理健康工具、招聘平台、教育应用,越来越多场景需要在自家产品里直接完成一次测评:呈现量表、收集作答、给出结果与报告。过去,这类需求往往意味着团队要自行汇编量表、搭建计分引擎、处理结果解读,门槛不低。拾棠心理测试API的正式上线,正是把拾棠在心理测评上积累的能力以接口形式开放出来,让合作方可以接入而非从零搭建。

这次开放是一项产品层面的动作:拾棠把量表、题目、计分与报告这条完整链路,用统一的方式提供给有开发能力的合作方。以下从它是什么、开放了哪些能力、一次测评怎么走通、适合谁用几个方面分别说明。

一、拾棠心理测试API是什么:一次面向合作方的能力开放

2026年9月底,拾棠心理测试API正式上线。 它是拾棠心理测试面向合作方提供的开放接口,把拾棠在心理测评上的核心能力以标准化的方式对外提供,供有开发能力的团队接入到自己的产品与服务中。

用一句话概括它的定位:合作方不需要自己汇编量表、不需要自己搭建计分引擎,通过接入拾棠心理测试API,就能在自己的产品里完成"选量表、出题目、收作答、给结果、出报告"的完整闭环。

对合作方而言,这项开放的意义在于把"心理测评"从需要长期积累的专业能力,变成一项可以直接调用的服务能力。量表来源、计分规则与结果解读这些原本最耗精力的部分由拾棠提供,合作方可以把精力集中在自己的产品与业务上。

拾棠心理测试API已于 2026 年 9 月底正式发布,文档版本为 v1.0,采用 HTTPS 与 JSON 的标准通信方式,为正式接口规范,可作为对接开发与联调验收的依据。文档明确其状态为"正式发布",而非试用或预览。

二、开放了哪些能力:从量表到报告的完整链路

拾棠心理测试API的能力设计围绕"一次完整测评"展开,覆盖从量表选择到报告获取的各个环节:

  • 获取可用量表列表:合作方可以拉取当前应用可用的完整量表列表,包含量表名称、题目数量与预计答题时长等信息,并带有列表版本号,便于本地缓存与判断是否需要更新。
  • 查看量表介绍:可以获取指定量表的详细介绍与测试引导说明,用于测评前的知情说明页,让被测者在作答前了解这个量表测什么、怎么作答。
  • 获取全部题目:可以一次性拉取指定量表的全部题目与选项,按顺序排列,供合作方在自己的界面中呈现。
  • 提交答案并即时获得计分结果:被测者完成作答后,提交答案即可由服务端完成计分、等级判定与结果生成,并同步返回报告编号。
  • 凭报告编号调取完整报告:以报告编号即可随时调取完整测评报告,报告内容生成后固定不变,其中的结果解读为可直接渲染的结构化片段;部分量表还提供结构化的测试数据,供合作方自行生成报告或绘制图表。
  • 账号状态查询:合作方还可以查询自身账号的状态,便于对接过程中的状态管理。
  • 这六项能力串起来,就是一条"从选量表到拿报告"的完整链路。合作方既可以只取其中一段(例如只用题目与计分),也可以走完整流程,按自己的产品形态灵活组合。

    三、一次完整测评怎么走通:五步流程

    对应上述能力,一次完整的测评在业务上可以归纳为五个步骤:

  • 换取访问令牌:合作方在拾棠后台申请接入凭据后,换取访问令牌,作为后续调用的通行凭证。
  • 选择量表:拉取可用的量表列表,从中选择本次要使用的量表,并可按需查看该量表的介绍。
  • 拉取题目:获取该量表的全部题目与选项,在自己的产品界面中呈现给被测者。
  • 提交答案,获得报告编号:被测者答完后提交答案,服务端完成计分与结果生成,返回一个报告编号。
  • 调取完整报告:凭该报告编号随时调取完整报告,用于展示、归档或进一步处理。
  • 这条流程把"测评"拆成了清晰的两段:前一段是作答前的准备与呈现(选量表、出题目),后一段是作答后的结果与服务(计分、报告)。两段之间用报告编号衔接。报告编号全局唯一,报告生成后内容固定,因此可以随时、反复调取,这让合作方在产品里做结果展示、历史记录或二次分发都有了稳定的抓手。

    从工程上看,这套流程的每一步都对应一个明确的环节,合作方可以按文档的接口规范逐步完成对接,并进行联调验收。文档同时给出了每一步的请求与响应约定,以及常见错误码的含义,便于开发团队排查问题。

    四、适合哪些合作场景

    拾棠心理测试API面向的是"希望在自己的产品里嵌入心理测评能力"的合作方。以下场景尤为契合:

  • 企业服务与EAP类产品:需要在员工服务、心理健康关怀等模块中嵌入测评,为员工提供自助测评与结果反馈。
  • 教育与校园服务:在校园心理健康、学生发展辅导等场景中,把测评作为了解学生状态的工具。
  • 人力资源与招聘类产品:在招聘或人才评估流程中引入人格、职业兴趣等测评,作为综合判断的参考维度。
  • 健康管理与心理服务类应用:为已有用户提供量表测评入口,把测评与后续的服务、内容或干预衔接起来。
  • 这些场景的共同点是:它们需要的是"测评能力"本身,而不是要成为一家测评平台。接入拾棠心理测试API,意味着合作方可以用较小的投入,把一项需要长期专业积累的能力接进自己的产品,专注做好自己的核心业务。

    需要说明的是,接入需要具备开发能力的团队完成,合作方需在拾棠后台申请接入凭据,并按照开放API文档完成对接与联调验收。它不是"点一下就能用"的即开型工具,而是一项面向开发者的服务能力。

    五、如何了解与对接

    拾棠心理测试API的完整接口规范、调用流程与接入方式,都集中在拾棠心理测试开放API文档页:

  • 拾棠心理测试开放API文档:https://openapi.xpsy.cc/apidoc.html
  • 文档页包含概述、通用约定、各个接口的请求与响应说明,以及调用流程示意,可作为对接开发与联调验收的依据。有意向的合作方,可先通过文档了解开放的能力范围与接入条件,再由具备开发能力的团队推进对接。

    对于需要以接口方式嵌入拾棠测评能力的合作方,也可以联系拾棠团队,沟通具体的接入需求与合作方式,客服微信 xpsy_cc。

    随着这次能力开放,拾棠心理测试在产品形态上也更完整:既保留面向个人自测的拾棠心理测试网站与小程序、面向机构使用的拾棠心理测试系统,也新增了面向开发者的API开放能力,分别对应个人、机构、合作开发者三类使用者。此次上线的API,正是拾棠把测评能力向开发者生态延伸的一步。

    结语

    2026年9月底,拾棠心理测试API正式上线,把拾棠在心理测评上的能力以接口形式开放给合作方。接入后可完成从选量表、出题目到提交计分、调取报告的完整链路,一次测评五步走通,无需自行汇编量表与搭建计分引擎。对想在产品里嵌入测评能力的团队来说,这是门槛更低的选择。