接口文档 - Sumt·Api

获取QQ好友列表

返回调试

会员免费

接口地址：https://api.sumt.cn/api/qq.friend.list.php

返回格式：json

请求方式：get

请求示例：https://api.sumt.cn/api/qq.friend.list.php?token=[尚未登录]&uin=123456789&skey=@QotaQV712&p_skey=rYiEv67J1qfsTeAwiNLcXHg4uZS6FxFPrCvf*O0IK*o_

请求参数说明：

名称	必填	类型	说明
token	是	string	调用接口凭证
uin	是	string	p_skey相对应的QQ号码
skey	是	string	登录后提取的空间skey
p_skey	是	string	登录后提取的空间p_skey

返回参数说明：

名称	类型	说明
code	string	返回的状态码
msg	string	返回错误信息
nums	string	返回账号好友数量
data	string	返回账号好友列表
group	string	返回账号分组列表
friend	string	返回账号好友列表
id	string	返回账号分组列表ID
uin	string	返回账号好友账号
name	string	返回账号好友昵称
remark	string	返回账号好友备注

请求返回示例：

{
    "code": 200,
    "msg": "获取成功",
    "nums": {
        "group": 9,
        "friend": 999
    },
    "data": {
        "group": [
            {
                ......
            }
        ],
        "friend": [
            {
                ......
            }
        ],
    }
}

服务级错误码参照：

错误码	说明
201	传递参数不能为空
202	QQ好友列表获取异常
203	传递参数格式不正确

系统级错误码参照：

错误码	说明
10011	密钥错误或不存在
10012	通讯密钥已被封禁
10013	通讯密钥申请注销
10014	地区已被系统屏蔽
10018	请求频率超过限制
10019	请求被限制或封禁
10021	接口异常或者停用
10022	账户密钥额度不足
10023	请求权限暂未开启
10024	请求的地区被屏蔽
10025	请求权限已被拉黑
10026	请求签名校验错误
10027	非白名单请求域名
10028	非白名单的IP地址

示例演示代码

PHP
JavaScript

<?php
// PHP示例演示代码

// 接口地址
$url = 'https://api.sumt.cn/api/qq.friend.list.php';

// 请求参数
$data = [
    'token' => '密钥通讯',
    'uin' => '123456789',
    'skey' => '@QotaQV712',
    'p_skey' => 'rYiEv67J1qfsTeAwiNLcXHg4uZS6FxFPrCvf*O0IK*o_',
];

// 发送请求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url . '?' . http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

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

// 输出结果
echo $result;
?>

// jQuery-Ajax
$.ajax({
    url: 'https://api.sumt.cn/api/qq.friend.list.php',  // 接口地址
    data: {
        // 请求参数
        token: '密钥通讯',
        uin: '123456789',
        skey: '@QotaQV712',
        p_skey: 'rYiEv67J1qfsTeAwiNLcXHg4uZS6FxFPrCvf*O0IK*o_',
    },
    type: 'GET', // 请求方式
    dataType: 'json', // 设置接收到的响应数据的格式
    timeout: 5000, // 超时时间
    beforeSend: function() {
        // 正在请求中...
    },
    success: function(data) {
        // 请求成功
        console.log(data);
    },
    error: function(err) {
        // 请求失败
        console.log('请求失败');
    }
});

项目信息

2点/¥0.002元/次单次对接价格

尚未申请通讯密钥通讯密钥凭证

2023-03-09 10:27:20 项目创建时间

2023-03-09 13:36:29 最后更新时间

自2023年03月09日，上线以来总累计提供数 784 次API接口调用服务。其中，昨日调用数 0 次，今日调用数 0 次。

使用须知

1.本平台提供的所有 API 接口，仅限个人学习、技术研究使用，禁止用于任何商业盈利、经营性项目。

2.禁止利用本接口从事违反《中华人民共和国网络安全法》《互联网信息服务管理办法》等相关法律法规的活动。

3.使用者需自行承担因使用本接口产生的一切法律责任，平台保留对违规使用账号的封禁、限制访问等权利。

4.本接口的技术文档、示例代码等内容的知识产权归平台所有，未经授权不得擅自篡改、传播、售卖。

5.平台有权根据运营情况调整、暂停或终止接口服务，无需提前通知用户。