这里将介绍,话题、心愿墙、时间瓶的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
方法 | 说明 |
---|---|
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 | 时间瓶显示的时间戳,在时间戳之前都无法获取 |