参数名	类型	必填	说明	示例
id	string	是	用户唯一标识，可为设备id等具有唯一性的值	1828222534
msg	string	是	游戏进行参数，可为：开始、重新开始、选项A/B/C/D	开始

人格测试

接口说明

这是一个基于多维心理学模型的性格推理游戏接口，通过15道随机题目描绘用户的性格画像。适用于需要互动式心理测试或性格分析功能的场景。

调用地址

/v1/game_xg.php

请求方式

支持 GET 或 POST 方法。

鉴权说明

本接口无需任何密钥或鉴权信息，可直接调用。

请求参数

参数名	类型	必填	说明
id	string	是	用户唯一标识，用于区分不同用户的游戏进程。
msg	string	是	游戏进行参数，用于控制游戏流程。

msg 参数取值说明：

开始：发起新的游戏。
重新开始：重置当前用户的游戏进度，重新开始。
选项A/B/C/D：回答当前题目，提交对应选项（A、B、C 或 D）。

成功响应示例

{
  "code": 0,
  "message": "游戏开始！总共15道题目，请认真作答。",
  "data": {
    "status": "playing",
    "question_number": 1,
    "total_questions": 15,
    "question": "当计划被打乱时，你的反应是：",
    "options": {
      "A": {
        "text": "灵活调整，顺势而为",
        "scores": {
          "E": 0,
          "R": 0,
          "A": 2,
          "O": 2,
          "D": 0
        }
      },
      "B": {
        "text": "感到烦躁，但还是会应对",
        "scores": {
          "E": 0,
          "R": 1,
          "A": -1,
          "O": -1,
          "D": 1
        }
      },
      "C": {
        "text": "重新规划，确保目标不变",
        "scores": {
          "E": -1,
          "R": 2,
          "A": -1,
          "O": 0,
          "D": 2
        }
      },
      "D": {
        "text": "顺其自然，没什么大不了的",
        "scores": {
          "E": 1,
          "R": -1,
          "A": 1,
          "O": 1,
          "D": -1
        }
      }
    },
    "hint": "请回复 A、B、C 或 D 来选择你的答案"
  }
}

响应字段说明

code: 响应状态码，0 表示成功。
message: 对当前游戏状态的文字描述。
data: 游戏核心数据对象。
- status: 游戏状态，playing 表示答题中，finished 表示已完成。
- question_number: 当前题目的序号。
- total_questions: 题目总数，固定为 15。
- question: 当前呈现的题目内容。
- options: 当前题目的选项列表，每个选项是一个对象。
  - A/B/C/D: 选项键，代表一个具体选项。
    - text: 该选项的文本描述。
    - scores: 该选项对应的性格维度得分。包含 E、R、A、O、D 五个维度，每个维度的值为整数，可为正、负或零。
- hint: 操作提示，指导用户如何继续游戏。

错误响应示例

当请求发生错误时，接口会返回以下格式的 JSON 响应：

{
  "code": 0,
  "msg": "请求过于频繁，请稍后再试。",
  "errcode": 11005
}

业务错误码说明

接口在处理请求时，可能返回以下业务错误码，具体含义如下表所示：

错误码 (errcode)	含义说明
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	***地址无效
11015	***地址不允许
11016	***请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前IP不在白名单内
11020	启用出口代理须提供有效密钥
11021	未配置可用出口代理
11022	出口代理不可用

调用示例

终端 curl（bash）

curl -X POST "https://api.example.com/v1/game_xg.php" \
  -H "Content-Type: application/json" \
  -d '{"id": "1828222534", "msg": "开始"}'

PHP

// PHP
$url = 'https://api.example.com/v1/game_xg.php';
$data = [
    'id' => '1828222534',
    'msg' => '开始'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

注意事项

用户标识：id 参数用于标识唯一用户，请确保其具有足够的唯一性（如设备ID、用户ID），以保证不同用户的游戏进度和性格画像互不干扰。
游戏进度：本接口为回合制游戏，需通过 msg 参数传递“开始”或“选项A/B/C/D”等指令来推进游戏。请妥善保存用户标识 id，并在同一用户的后续请求中保持其不变，以维持游戏会话的连续性。
参数格式：msg 参数的值需严格遵循示例，例如“开始”、“选项A”、“选项D”。传递其他非预期值可能导致游戏流程中断或返回错误。
免费使用：本接口为免费服务，但请注意合理调用频率，避免对服务造成不必要的压力。

人格测试

请求参数

返回示例

详细文档

人格测试

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

二维码生成