QQ名片跳转

接口说明

用于生成 QQ 名片跳转能力，传入目标 QQ 号即可完成名片页跳转。适合需要在网页或应用内引导用户直达指定 QQ 资料页的开发者使用，免费调用，无需密钥。

调用地址

https://mini10.top/api/tz.php

该地址为 QQ 名片跳转接口的完整调用地址，可直接用于发起请求。

请求方式

本接口使用 GET 方式发起请求。

调用时需在请求地址中携带参数 uin（字符串，必填），其值表示需要跳转的目标 QQ 号，例如 3596407014。

鉴权说明

本接口无需密钥，发起请求时不需要携带任何鉴权参数，也不需要在请求头或查询参数中附加身份凭据，可直接调用。

本接口免费使用。

请求参数

调用地址：https://mini10.top/api/tz.php，请求方式：GET，无需密钥。

参数取值说明：

• uin 仅接受数字字符串，不要包含空格、符号或前缀。
• 该参数直接决定跳转目标，需与调用地址一同以查询参数形式提交。

成功响应示例

接口以 JSON 形式返回结果，code 为 200 表示本次调用成功；data 中同时给出目标 QQ 号与本次跳转地址，浏览器直接访问该地址时会完成名片页跳转。

{
  "code": 200,
  "msg": "success",
  "data": {
    "uin": "3596407014",
    "url": "https://mini10.top/api/tz.php?uin=3596407014"
  }
}

响应字段说明

说明：data 内的字段随调用成功返回；若未携带必需的 uin 参数，则不返回该对象。

错误响应示例

接口在参数校验失败、请求方式不正确或服务暂不可用时，统一返回 JSON 格式的错误信息，HTTP 状态码保持常规返回，业务结果由响应体中的 code 与 errcode 字段表示。

参数缺失或取值不合法时：

{"code":0,"msg":"缺少必填参数 uin","errcode":11012}

请求方式不符合要求（本接口仅支持 GET）时：

{"code":0,"msg":"请求方式不允许","errcode":11018}

接口处于维护状态时：

{"code":0,"msg":"接口维护中","errcode":11006}

接口已被关闭时：

{"code":0,"msg":"接口已禁用","errcode":11007}

调用地址填写有误、接口不存在时：

{"code":0,"msg":"接口不存在","errcode":11013}

服务整体暂不可用、无法完成本次请求时：

{"code":0,"msg":"服务暂不可用","errcode":11017}

响应体字段说明：

业务错误码说明

下表列出本站全部业务错误码及其含义。本接口无需密钥且免费，通常不会返回与密钥、积分相关的错误码，但同一站点内其他接口可能返回，故一并列出以便排查。

调用示例

终端 curl（bash）

curl -L "https://mini10.top/api/tz.php?uin=3596407014"

PHP

// PHP 示例
$uin = "3596407014";
$url = "https://mini10.top/api/tz.php?uin=" . urlencode($uin);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

注意事项

• 本接口无需密钥，调用地址为 https://mini10.top/api/tz.php，请直接以 GET 方式请求，不要把任何密钥或身份信息拼入链接。
• uin 为必填参数，取值为纯数字的 QQ 号字符串（示例：3596407014）。请勿传入 +、空格、@qq.com 后缀或其他非数字字符，否则可能导致跳转目标异常。
• 该接口会返回跳转结果而非结构化数据，请在实际使用中以浏览器或 HTTP 客户端的跳转行为为准，不要按 JSON 格式解析响应体。
• 将本接口用于页面或客户端时，建议由业务侧自行校验用户输入的 QQ 号格式后再发起请求，避免把无效参数直接透传给调用地址。
• 虽然接口免费且无需密钥，仍请勿高频轮询或批量压测；对同一 QQ 号的重复跳转请求应做必要的缓存或节流，以免影响正常访问。
• 生产环境请始终使用 HTTPS 访问上述地址，不要降级为 HTTP，防止跳转参数在传输过程中被篡改。
• 跳转目标由 uin 决定，请勿在公开页面中把本接口与不受控的第三方参数拼接，防止被构造为任意跳转入口。
• 接口返回内容可能随目标页面变化，请勿依赖固定的响应文本做业务判断；如需展示结果，建议以最终落地页为准。