校园-内容系统API

这里将介绍,话题、心愿墙、时间瓶的API接口
这里的文档使用了本接口全部使用的通用的内容处理接口。这部分内容将在第0节提供,后续仅说明增补内容

0.通用参数

0.1 通用常量

名称 说明
config部分,请用或运算连接这些标记
post_special 0x10 特殊贴标记,标记非标准内容的帖子
post_protect 0x20 保护的主题帖标记
post_normal 0x01 正常帖子应该都需要此标记
post_xml 0x04 含有图文的时候需要这个标记
display部分,仅能够取一个值
display_normal 1 被正常显示的帖子
display_top 2 被置顶的帖子
display_none 0 隐藏的帖子
status部分,用或运算连接
status_block 0x0002 被屏蔽的帖子
status_delete 0x0001 回收站的帖子
status_normal 0x0004 正常贴的标记
status_noshort 0x0008 不裁剪生成摘要
ststus_top_1 0x0010 局部置顶
ststus_top_2 0x0030 全局置顶

0.2. 通用输入参数

参数 说明
access_token 登录获取的access_token,发送的时候请urlencode
title 帖子的标题
content 帖子的内容
config 配置方法参见本章第一节常数部分,这个参数不可缺少,缺少这个参数将引起服务器抛出Notice异常影响返回数据
class forum 常量

0.3. 通用输出参数

参数 说明
title 帖子的标题
content 帖子的内容
config 配置方法参见本章第一节常数部分,这个参数不可缺少,缺少这个参数将引起服务器抛出Notice异常影响返回数据
fid 心愿墙为1,时间瓶为uid
display 参见第1节的配置
status 见第1节的配置
create 帖子创建的时间戳
author 创建者的昵称
authorid 创建者的uid
lastedit 最后编辑时间
id 帖子的唯一id,用于回复及查询
uppost 上级帖子的id,主题没有这个值
college 学校的id

0.4. 通用方法

方法是指action值,post时必须附带这个参数,否则将输出invalid input

0.4.1.获取主题列表的参数

方法 说明
postnew 创建帖子的方法,输入参数参见0.2节
showlist 获取主题帖的列表,参数见0.4.1
response 回复功能,时间瓶不可用,在0.2节中去除title参数
editpost 修改帖子的方法,tid为帖子id,其他输入参数见输入参数0.2节
getpost 通过主题帖tid参数获取所有回复,时间瓶不可用 参数n,p与0.4.1相同
参数 说明
n 每次请求的条数
page 请求的页码
fid 分区id

1.话题功能

固定参数:

mod=topic

话题实现全部通用功能
输入附加项:

参数 说明
fid 话题的分区id,必须参数,创建时不可省略,修改、回复时不可添加

2.心愿墙

固定参数:

mod=wish

返回中的author和authorid会被删除,其他与通用参数相同

3.时间瓶

固定参数:

mod=timebottle

通用方法除去回复
输入附加项:

参数 说明
showtime 时间瓶显示的时间戳,在时间戳之前都无法获取