用途:SoulTrace 提供自适应人格测评,用户完成 24 道题后得到基于五色心理模型的人格原型。
主要能力:API 无状态,每次请求需携带全部已答题目,服务器重放贝叶斯推断以选择下一道最优题目。返回内容包括当前颜色分布、熵值、进度,完成后返回 resultId、resultUrl、最终分布、原型(名称、alignmentScore、核心动力、优势、弱点)、前三匹配原型及阴影颜色。
使用方式:接口为 POST https://soultrace.app/api/agent,无需认证。先发送空 answers 数组获取第一题,例如 curl -X POST https://soultrace.app/api/agent -H "Content-Type: application/json" -d '{"answers": []}'。用户按 1-7 作答(1=非常不同意,4=中立,7=非常同意),每次追加答案并发送全部历史答案,如 {"answers": [{"questionId": 42, "score": 6}]}。24 题后自动返回最终结果。GET 同一地址可获取 API 元数据。
适用场景:适合在对话中引导用户完成人格测评,并展示原型、颜色百分比、前三匹配及完整结果页链接。
限制:限速 100 请求/小时/IP,每次测试需 25 次请求,约每小时最多 4 次完整测试。错误码包括 400(请求体或答案格式无效)、429(超限,可查看 Retry-After)、500(服务器错误)。不应跳过题目或替用户自动作答。非数字回答可按资料给出的映射转换为 1-7 分。五色分别对应结构公平、理解精通、能动成就、强度表达、连接成长。