Skip to content

强制跳转QQ API

1. 基本调用

请确保在支持QQ协议的环境中使用此API,以获得最佳体验。

基本 API 地址

txt
https://zeapi.ink/v1/api/qzztqq

通过 GET 请求实现强制跳转到QQ的聊天界面、加好友界面或WPA临时会话:

txt
https://zeapi.ink/v1/api/qzztqq?type=chat&uin=123456

Shell 请求示例

shell
curl https://zeapi.ink/v1/api/qzztqq?type=chat&uin=123456

获取 JSON 格式输出

在 URL 中添加 format=json 参数以获取 JSON 格式的跳转信息:

txt
https://zeapi.ink/v1/api/qzztqq?type=chat&uin=123456&format=json

Shell 请求示例(JSON 格式)

shell
curl https://zeapi.ink/v1/api/qzztqq?type=chat&uin=123456&format=json

POST 请求示例(JSON 格式)

通过 POST 请求发送 JSON 数据获取跳转信息:

shell
curl -X POST -H "Content-Type: application/json" -d '{"type":"chat","uin":"123456","format":"json"}' https://zeapi.ink/v1/api/qzztqq

2. 请求参数说明

参数类型必填默认值说明
typestring操作类型,可选值:chat(跳转到聊天界面)、addfriend(跳转到加好友界面)、wpa(WPA临时会话)
uinstring目标QQ号码,必须为数字
formatstringredirect输出格式,可选值:json(返回跳转信息)或 redirect(直接重定向到QQ界面)

3. JSON 响应格式

成功响应示例(JSON 格式)

json
{
    "status": "success",
    "type": "chat",
    "uin": "123456",
    "url": "mqqwpa://im/chat?chat_type=wpa&version=1&src_type=web&web_src=oicqzone.com&uin=123456"
}

成功响应示例(redirect 格式)

API 将返回一个 HTTP 302 重定向响应,客户端将自动跳转到对应的 QQ 界面。

错误响应示例(参数错误)

json
{ "code": 400, "error": "Invalid uin or type." }

错误响应示例(服务器错误)

json
{ "code": 500, "error": "Server error: [错误描述]" }

4. 响应字段说明

字段类型说明
codeint响应状态码(200 表示成功,400 表示参数错误,500 表示服务器错误)
statusstring操作结果状态(仅 JSON 格式,success 表示成功)
errorstring错误信息(仅在出错时返回)
typestring操作类型(仅 JSON 格式,例如 chat
uinstring目标QQ号码(仅 JSON 格式,例如 123456
urlstring跳转的 URL(仅 JSON 格式,例如 mqqwpa://im/chat?...

基于 MIT 协议发布。