[
    {
        "name": "key",
        "type": "string",
        "required": true,
        "description": "接口调用密钥",
        "example": ""
    },
    {
        "name": "action",
        "type": "string",
        "required": true,
        "description": "操作类型。支持 start（开始测试）、restart（重新开始）、status（查询当前状态）、answer（提交答案）。",
        "example": "start"
    },
    {
        "name": "id",
        "type": "string",
        "required": true,
        "description": "玩家唯一标识，用于保存和读取本次性格测试进度。仅支持字母、数字、中文、下划线和短横线，最长 50 个字符。",
        "example": "player_10001"
    },
    {
        "name": "answer",
        "type": "string",
        "required": false,
        "description": "答题选项，仅当 action=answer 时必填，可选值为 A、B、C、D。",
        "example": "A"
    }
]

{
    "openapi": "3.1.1",
    "info": {
        "title": "性格测试",
        "description": "互动式性格测试，15 道随机题，按外向性、理性度、冒险性、乐观度、主导性计算并返回标签。",
        "version": "1.0.0"
    },
    "paths": {
        "\/api\/game\/traitgame\/index.php": {
            "get": {
                "summary": "性格测试",
                "description": "互动式性格测试，15 道随机题，按外向性、理性度、冒险性、乐观度、主导性计算并返回标签。",
                "parameters": [
                    {
                        "name": "key",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "接口调用密钥"
                    },
                    {
                        "name": "action",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "start"
                        },
                        "description": "操作类型。支持 start（开始测试）、restart（重新开始）、status（查询当前状态）、answer（提交答案）。"
                    },
                    {
                        "name": "id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "player_10001"
                        },
                        "description": "玩家唯一标识，用于保存和读取本次性格测试进度。仅支持字母、数字、中文、下划线和短横线，最长 50 个字符。"
                    },
                    {
                        "name": "answer",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "A"
                        },
                        "description": "答题选项，仅当 action=answer 时必填，可选值为 A、B、C、D。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "成功",
                        "content": {
                            "application\/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "servers": [
        {
            "url": "https:\/\/api.vsaa.cn",
            "description": "当前访问入口（https）"
        }
    ]
}

**开始测试：`action=start`**

```json
{
  "code": 0,
  "message": "游戏已开始",
  "data": {
    "status": "playing",
    "question_number": 1,
    "total_questions": 15,
    "progress": "0%",
    "question": "在一个热闹的聚会上，你通常会：",
    "options": {
      "A": {
        "text": "主动与很多人交谈，成为焦点",
        "scores": {
          "E": 2,
          "R": 0,
          "A": 1,
          "O": 1,
          "D": 1
        }
      },
      "B": {
        "text": "和几个熟悉的朋友待在一起聊天",
        "scores": {
          "E": 0,
          "R": 1,
          "A": 0,
          "O": 0,
          "D": 0
        }
      }
    }
  }
}
```

**提交答案：`action=answer`**

```json
{
  "code": 0,
  "message": "答案已记录",
  "data": {
    "status": "playing",
    "question_number": 2,
    "total_questions": 15,
    "progress": "7%",
    "question": "周末你更倾向于怎样度过？",
    "options": {
      "A": {
        "text": "约朋友出去聚会或户外活动",
        "scores": {
          "E": 2,
          "R": -1,
          "A": 1,
          "O": 1,
          "D": 0
        }
      }
    }
  }
}
```

**测试完成：`action=answer`，最后一题**

```json
{
  "code": 0,
  "message": "已完成全部题目",
  "data": {
    "status": "finished",
    "result": {
      "label": "社交达人 + 无畏探险家",
      "analysis": {
        "E": {
          "level": "高度外向性",
          "desc": "你的外向性特征非常明显。"
        },
        "R": {
          "level": "平衡理性度",
          "desc": "你的理性度两种倾向较为均衡。"
        },
        "A": {
          "level": "偏向冒险性",
          "desc": "你的冒险性特征较为明显。"
        },
        "O": {
          "level": "高度乐观度",
          "desc": "你的乐观度特征非常明显。"
        },
        "D": {
          "level": "偏向主导性",
          "desc": "你的主导性特征较为明显。"
        }
      },
      "scores": {
        "E": 9,
        "R": 1,
        "A": 6,
        "O": 10,
        "D": 4
      }
    }
  }
}
```

**请求错误示例**

```json
{
  "code": 400,
  "message": "答案必须是 A、B、C 或 D",
  "data": null
}
```