校园-广场功能API

广场包括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 getpostresponse
发送和返回时没有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 心愿回复时的积分规则,针对于被回复者