荔园在线
荔园之美，在春之萌芽，在夏之绽放，在秋之收获，在冬之沉淀
[回到开始]
[上一篇][下一篇]
发信人: jjk (kernel), 信区: InstallBBS
标 题: 一个c/s结构的bbs接口协议详细说明[fwd]
发信站: 荔园晨风BBS站 (Sun Mar 10 09:46:33 2002), 转信
【 以下文字转载自 jjk 的信箱 】
【 原文由 jjk.bbs@bbs.nju.edu.cn 所发表 】
发信人: zhch (zhch), 信区: BBSDev
标 题: 一个c/s结构的bbs接口协议详细说明[fwd]
发信站: 南京大学小百合站 (Thu Mar 7 16:23:07 2002), 站内信件
一个c/s结构的bbs接口协议详细说明
代码下载: http://bbs.nju.edu.cn/download/icq.c
更新时间: 2001-08-1
这是一套for FB的bbs接口程序.
这个程序使用了NJU WEB BBS 0.9的BBSLIB.inc.
程序说明:
函数参数按名存取, 可随意增减, 扩展性强.
参数名称大小写不敏感.
所有函数(除login外), 都要登录成功后才能使用.
返回值:
成功返回1, 出口参数将被赋值.
失败返回0, 出口参数不赋值, error存放具体出错信息.
1, int login(id, pw, ...)
函数作用: 用户登录
入口参数:
id: 用户名
pw: 密码
出口参数:
UTMPNUM: 在线信息1 (cgi用)
UTMPKEY: 在线信息2 (cgi用)
USERID: 用户名
ANNO: 重要系统通知
2, int logout()
函数作用: 注销登录
入口参数: 无
出口参数: 无
3, int query(id, ...)
函数作用: 查询网友
入口参数: id:用户名
出口参数:
USERID: 用户名
LASTHOST: 最后上站地址
NUMLOGINS: 上站次数,
NUMPOSTS: 文章数
USERNAME: 昵称
LASTLOGOUT: 最后离站时间
LIFE: 生命力
EXP: 经验值
CEXP: 中文经验值
PERF: 表现值
CPERF: 中文表现值,
GENDER: M or F, 性别
ONLINE: 在线窗口数
(其他属性有待扩充)
4, int myinfo()
函数作用: 获得自己的个人资料
入口参数: 无
出口参数:
USERNAME: 昵称
ADDRESS: 居住地址
GENDER: 性别,
BIRTHYEAR, BIRTHMONTH, BIRTHDAY: 出生年月日
5, int getplan(id, ...)
函数作用: 查询用户的个人说明档
入口参数: id:用户帐号
出口参数:
PLAN(数组): 说明档内容.
6, int getfriend(...)
函数作用: 获得在线好友列表
入口参数: 无
出口参数:
FRIEND: 在线好友数,
ID(数组): 好友用户名
NICK(数组): 好友昵称
MODE(数组):好友状态
7, int getallfriend(...)
函数作用: 获得好友名单
入口参数: 无
出口参数:
ID(数组): 好友用户名
EXP(数组): 好友说明
8, int addfriend(id, exp)
函数作用: 增加好友
入口参数:
id: 好友帐号
exp: 好友说明
出口参数:
无
9, int gettime()
函数作用: 获得服务器时间
入口参数: 无
出口参数:
T:服务器时间
10, int sendmsg(id, pid, msg)
函数作用: 发送讯息
入口参数:
id:用户名
pid:用以区分同一id不同窗口的标志符
msg: 讯息内容
出口参数: 无
备注: 若不知对方pid, 则pid置0, 可发给在线窗口的第1个.
11, int getnewmsg(...)
函数作用: 检查并取得1条新讯息
入口参数: 无
出口参数:
ID:发讯息的用户名
MSG:讯息内容
PID:发讯息者的pid.
12, int getallmsg(...)
函数作用: 获取服务器上的所有讯息备份
入口参数: 无
出口参数:
TYPE: SEND或GET, 表明该讯息是发出的讯息还是接收到的讯息
ID(数组): 对方用户名
MSG(数组): 讯息内容
PID(数组): 发讯息者的pid.
13, int clearmsg()
函数作用: 清除服务器上所有讯息备份
入口参数: 无
出口参数: 无
14, int checkmail(...)
函数作用: 检查是否有新邮件
入口参数: 无
出口参数: NEW: 新邮件数目
15, int delfriend(id)
函数作用: 从好友名单中删除好友
入口参数: id: 待删除的好友用户名
出口参数: 无
16, int countonline()
函数作用: 获得在线用户数
入口参数: 无
出口参数: COUNTONLINE: 在线用户数
17, int countuser()
函数作用: 获得注册用户数
入口参数: 无
出口参数: COUNTUSER: 注册用户数
18, int setinfo(username, pass, address)
函数作用: 修改个人资料或密码
入口参数:
username: 新昵称
pass: 新密码
address: 新地址
出口参数: 无
备注: 其他参数有待添加
19, int getblackall(...)
函数作用: 获取坏人名单
入口参数: 无
出口参数:
ID(数组): 坏人用户名
EXP(数组): 坏人说明
20, int addblack(id, exp)
函数作用: 添加坏人名单
入口参数:
ID: 坏人用户名
EXP: 坏人说明
出口参数: 无
21: int delblack(id)
函数作用: 删除坏人
入口参数: ID: 坏人ID
出口参数: 无
示例:
1, 调用setfinfo函数把密码设置为12345:
发送:
ACT=SETINFO\n
PASS=12345\n
\n
返回:
RES=1\n
\n
2, 调用getplan函数获得afour的个人说明档:
发送:
ACT=GETPLAN\n
ID=afour\n
\n
返回:
RES=1\n
PLAN=\n
PLAN=\n
PLAN= 人生没有彩排，\n
PLAN= 每一天都是现场直播！\n
PLAN=\n
PLAN= 请看 真我子龙！\n
\n
手工调试方法:
使用支持回显的telnet工具, telnet bbs.nju.edu.cn 27027, 仿照以上格式进行进行操作.
--
zhch.bbs@bbs.nju.edu.cn
※ 来源:．南京大学小百合站 bbs.nju.edu.cn．[FROM: dsl.nju.edu.cn]
--
※ 转寄:．南京大学小百合站 bbs.nju.edu.cn．[FROM: 深圳大学BBS]
--
※ 转载:·荔园晨风BBS站 bbs.szu.edu.cn·[FROM: 192.168.0.146]
[回到开始]
[上一篇][下一篇]
荔园在线首页 友情链接：深圳大学 深大招生 荔园晨风BBS S-Term软件 网络书店