人格测试接口集成指南

通过简单的 API 集成，在您的应用中无缝嵌入专业的 MBTI 性格测试服务。我们提供全托管的测试流程，确保用户体验的一致性与专业性。

01. 集成方式

iframe

Iframe 嵌入

在您的应用页面内直接通过 iframe 标签加载测试链接，保持用户在您的平台内不离开。

open_in_new

新窗口跳转

引导用户至我们托管的测试页面，完成后通过回调 URL 自动引导用户返回您的应用。

02. 请求地址 (Request URL)

GET 请求

https://mbti.7373.com.cn/api/v1/test?external_user_id=UNIQUE_ID&callback_url=YOUR_CALLBACK_URL&access_key=YOUR_ACCESS_KEY&sign=GENERATED_SIGN

03. 参数说明 (Parameters)

所有请求都必须在 URL 参数中包含有效的 access_key。

参数名	必选	类型	最大长度	说明
access_key	必选	字符串	128	身份验证密钥，通过 URL 参数传递
external_user_id	必选	字符串	64	客户端用户的唯一标识符，用于关联结果
callback_url	必选	字符串 (URL)	255	测试完成后接收结果的 Webhook URL
lang	可选	字符串	10	语言设置，默认 'zh-CN'。支持 'en-US'
sign	必选	字符串	32	请求签名，详见签名算法说明

04. 签名算法 (Signature Algorithm)

为了保证 API 请求的安全性，所有请求都必须携带 sign 参数。签名生成的步骤如下：

将所有请求参数（除 sign 外）按照参数名的字典顺序（ASCII码）进行排序。
将排序后的参数及其对应值以 key=value 的形式用 & 符号连接成字符串。
在拼接后的字符串末尾加上 &secret_key=YOUR_SECRET_KEY。
对最终生成的字符串进行 MD5 加密（32位小写），得到最终的签名。

待签名原始字符串示例


                            access_key=YOUR_ACCESS_KEY&callback_url=YOUR_URL&external_user_id=ID&secret_key=YOUR_SECRET_KEY

05. 回调机制 (Callback Mechanism)

当用户在我们的平台上完成所有测试题目后，系统将自动发起一个 POST 请求到您提供的 callback_url。

info

回调请求包含 application/json 格式的 Payload。为了安全，建议在您的后端验证回调来源的 IP 或使用签名校验。

回调 JSON 示例

{
  "event": "test.completed",
  "timestamp": 1698765432,
  "data": {
    "external_user_id": "U_8829102",
    "test_id": "mbti_v1_002",
    "result_type": "INFJ",
    "personality_name": "提倡者",
    "scores": {
      "extraversion": 24,
      "introversion": 76,
      "sensing": 45,
      "intuition": 55,
      "thinking": 30,
      "feeling": 70,
      "judging": 80,
      "perceiving": 20
    },
    "summary": "富有想象力和战略性的思想家，一切皆在计划之中。"
  }
}