广场包括2个功能,1.心愿墙 2.公告板
1.心愿墙
固定参数
class=playground&mod=wishes
access_token请在这个章节全部附加,没有登录数据将会引起拒绝访问
1.1. 发布心愿
参数列表
参数 | 说明 | |
---|---|---|
action | 固定值postnew | |
private | 时间瓶专用参数,如果使用的是时间瓶功能请设置为需要显示的unix时间戳,不是时间瓶就置零或者去除这个参数 | |
title | 标准帖子参数,标题,不允许以美元符号开头 | |
content | 内容 |
返回数据
见最后一节通用返回
1.2. 获取单条数据
该功能用于获取单条信息包括回复
参数列表
参数 | 说明 |
---|---|
action | getpost |
id | 必须参数需要获取帖子的id |
n | 每次返回的条数,缺少这个参数时默认10条 |
page | 第几页,默认为1 |
返回帖子的json格式
由于心愿是匿名的,返回的creator值全部为0
返回的是一个标准帖子格式的json数组,量与请求的n值有关,之后所有的帖子格式返回全部为这个格式
下表为所有帖子的返回格式,本章全局适用。返回的实际值是一个数组,每个数组包含以下信息
参数 | 说明 |
---|---|
id | 帖子的id |
creator | 创建者的uid |
title | 帖子的标题,如果是回复是以$R开头的数据,请忽略它 |
content | 帖子的内容 |
private | 时间瓶专用,为显示消息的时间,时间瓶消息需要专用的方法获取,而且只能获取自己的信息,服务器时间必须大于这个值才能取到这条消息 |
create | mysql创建的时间戳,为帖子发布时间 |
college | 学校的id |
lastedit | 帖子的最后修改时间 |
status | 主题帖的id,通常情况下不需要使用 |
1.3. 获取时间瓶消息
凡是时间瓶的消息均不允许回复,并且仅本人可以读,虽然直接调用回复接口可以回复但是永远不会被显示出来。
时间瓶仅能取得设定时间之后的消息。
参数 | 说明 |
---|---|
action | getprivate |
n | 每次返回的条数,缺少这个参数时默认10条 |
page | 第几页,默认为1 |
返回参数见1.2节 帖子的返回格式
1.4. 获取主题列表
注意:这个方法获取的内容是前100个字符,且不包含回复的内容,获取的信息不包含作者(creator为0)
参数 | 说明 |
---|---|
action | showlist |
n | 每次返回的条数,缺少这个参数时默认10条 |
page | 第几页,默认为1 |
返回参数见1.2节 帖子的返回格式
回复消息
参数 | 说明 |
---|---|
action | response |
id | 回复主题帖的id |
content | 回复的内容 |
2. 公共信息服务
这里与心愿墙的区别就是信息非匿名,且允许置顶(特权动作,暂时不展示)
固定参数
class=playground&mod=broad
本节不再复述上章的接口,仅说明区别
仅保留4个接口:postnew showlist getpost和response
发送和返回时没有private选项
返回时多一项level,标记置顶帖用,请忽略
3. 通用返回
errcode | errmsg |
---|---|
40001 | 用户积分不足 |
10001 | 成功 |
10001 | 操作成功,但是被回复的用户id异常 |
50001 | 缺少必要的参数 |
40002 | 标题不合法 |
40003 | 标题长度过长 |
注意,获取帖子的时候可能会返回false,代表空数组
4. 运营配置参数
configure表信息
参数 | 说明 |
---|---|
domain | 固定值:credit_rules,积分规则配置 |
key | 积分配置键值 |
value | 序列化的二维数组,key和value两键值组成的数组排列,key代表积分的id,value代表积分的增值,减小设置为负数 |
需要配置的积分规则
键值(key) | 说明 |
---|---|
post_create | 公共消息发送是的积分规则 |
post_response | 公共消息回复时的积分规则,针对于回复者 |
post_responsed | 公共消息回复时的积分规则,针对于被回复者 |
wish_create | 心愿发布时的积分规则 |
wish_response | 心愿回复时的积分规则,针对于回复者 |
wish_responsed | 心愿回复时的积分规则,针对于被回复者 |