来源:http://blog.hackfan.net/
2005.8.18
QQ客户端,使用腾讯tqq.tencent.com:8000 HTTP接口
参考文章:http://spaces.msn.com/members/mprogramer
使用到的类:
Advanced HTTP Client
中文编码集合类库
类接口:
初始化类:
$qq = new QQClient(@#106814@#,@#password@#);
登陆:
$qq -> login();
参数:
void
返回:
服务器返回成功:
登陆成功:QQ_LOGIN_SUCCESS
登陆失败:QQ_LOGIN_FAILED
同时,全局变量$QQ_ERROR_MSG记录了服务器返回的错误说明
服务器返回失败:QQ_RETURN_FAILED
获得好友列表:
$qq -> getFriendsList();
参数:
void
返回:
成功:
array
(
QQ号码,
)
失败:QQ_RETURN_FAILED
获得在线列表:
$qq -> getOnlineList();
参数:
void
返回:
成功:
好友数 > 0
array
(
array
(
"UN" => QQ号码,
"NK" => QQ昵称,
"ST" => QQ状态,
"FC" => QQ头像
),
)
关于ST:
10为上线QQ_STATUS_ONLINE,20为离线QQ_STATUS_OFFLINE,30为忙碌QQ_STATUS_BUSY
关于FC:
FC为QQ头像的的ID,如的头像ID为270,那么其头使用的图片为91.bmp,其算法为FC/3+1
好友数 = 0
QQ_LIST_NONE
错误:
!(在线好友数==在线好友昵称数==在线好友状态数==在线好友头像数):QQ_LIST_ERROR
失败:QQ_RETURN_FAILED
获得号码信息:
$qq -> getInfo(@#106814@#);
参数:
string QQ号码
返回:
成功:
array
(
@#AD@# => , //联系地址
@#AG@# => , //年龄
@#BT@# => , //血型
@#CO@# => , //星座
@#CT@# => , //城市
@#CY@# => , //国家
@#EM@# => , //Email
@#FC@# => , //头像
@#HP@# => , //网站
@#JB@# => , //职业
@#MO@# => , //移动电话
@#PC@# => , //邮编
@#PH@# => , //联系电话
@#PR@# => , //简介
@#PV@# => , //省
@#RN@# => , //真实姓名
@#SC@# => , //毕业院校
@#SX@# => , //性别
@#UN@# => , //QQ号
@#NK@# => //昵称
)
失败:QQ_RETURN_FAILED
添加好友:
$qq -> addFriend( @#106814@# );
参数:
string QQ号码
返回:
成功:
对方允许任何人加为好友:QQ_ADDTOLIST_SUCCESS;
需要验证:QQ_ADDTOLIST_NEEDAUTH;
不允许任何人加为好友:QQ_ADDTOLIST_REFUSE;
未知的代码:QQ_ADDTOLIST_UNKNOWN;
失败:QQ_RETURN_FAILED
验证:
$qq -> replyAdd( @#106814@# , TYPE, MSG );
参数:
string QQ号码
enum(0,1,2) 类型
*0表示“通过验证”,1表示“拒决加为对方为好友”,2表示“为请求对方加为好友”
string 理由
返回:
成功:QQ_RETURN_SUCCESS
失败:QQ_RETURN_FAILED
删除好友:
$qq -> delFriend( @#106814@# );
参数:
string QQ号码
返回:
成功:QQ_RETURN_SUCCESS
失败:QQ_RETURN_FAILED
改变状态:
$qq -> changeStatus( QQ_STATUS );
参数:
enum(QQ_STATUS_ONLINE,QQ_STATUS_OFFLINE,QQ_STATUS_BUSY) 类型
返回:
成功:QQ_RETURN_SUCCESS
失败:QQ_RETURN_FAILED
登出:
$qq -> logout();
参数:
void
返回:
成功:QQ_RETURN_SUCCESS
失败:QQ_RETURN_FAILED
接收信息:
$qq -> getMsg();
参数:
void
返回:
消息数 > 0
array
(
array
(
"MT" => 消息类型,
"UN" => 发送者号码,
"MG" => 消息内容
),
)
关于MT:
9为用户消息,99为系统消息,2为请求信息,3为通过验证,4为拒绝被加好友
关于MG:
当MT=9时,MG为用户发送的消息内容
当MT=99时,
MG=10(QQ_STATUS_ONLINE)表示对方上线
MG=20(QQ_STATUS_OFFLINE)表示对方下线
MG=30(QQ_STATUS_BUSY)表示对方进入忙碌状态
当MT=2时,MG为请求验证的信息
当MT=3时,MG为?
当MT=4时,MG为拒绝理由
好友数 = 0
QQ_LIST_NONE
错误:
!(在线好友数==在线好友昵称数==在线好友状态数==在线好友头像数):QQ_LIST_ERROR
失败:QQ_RETURN_FAILED
发送信息:
$qq -> sendMsg($uin,$msg);
参数:
返回:
成功:QQ_RETURN_SUCCESS
失败:QQ_RETURN_FAILED
解释:
QQ_RETURN_SUCCESS表示服务器返回执行成功的信息
QQ_RETURN_FAILED表示服务器没有正确返回或者返回没有正确执行
本代码处于调试状态,当服务器没有正确返回的时候,将会打印出详细的信息
运行:推荐在Console模式下运行本程序,不建议使用WebServer运行。
延伸阅读
文章来源于领测软件测试网 https://www.ltesting.net/