http://bbs.uestc.edu.cn/mobcent/app/web/index.php?r=命令 （命令为 xxx/yyy 格式，例如用户登录为 user/login）

应该使用 POST 方法，但是实际上 GET 方法通常也可以。上传附件时使用 POST 方法，其他参数也放在 URL 中。返回结果通常为 JSON，有比较固定的格式，应该比较容易读懂。部分 API（特别是以 view 结尾的那几个）返回 HTML。

用户登录后的认证参数。

public static function getAppHashValue($special='') {
    $authkey = 'appbyme_key'; // 目前是定死的, 以后应该改成由用户设置
    $hash = substr(md5(substr(time(), 0, 5).$authkey.$special), 8, 8);
    return $hash;
}

PHP time() 对应的 Java 版本：https://stackoverflow.com/questions/732034/getting-unixtime-in-java Java MD5：https://stackoverflow.com/a/415971/1841048

API 版本，大部分情况下有没有这个参数以及参数值是什么都没有影响。 grep sdkVersion 出来，只有这几个区别：

mobcent/app/components/web/ImageUtils.php

private static function _getThumbUrlFile($image, $thumb) {
    return sprintf('%s/%s/%s/%s_%s', 
        Yii::app()->getController()->dzRootUrl,
        MOBCENT_THUMB_URL_PATH,
        self::_getThumbTempPath($image),
        (isset($_GET['sdkVersion']) && $_GET['sdkVersion'] > '1.0.0') ? 'xgsize' : 'mobcentSmallPreview',
        $thumb
    );
}

mobcent/app/components/web/AppUtils.php 那一段待确认，估计跟我们调用 API 没什么关系。

用于 mobcent 统计，区分不同论坛，很久以前抓包时值为 CBQJazn9Wws8Ivhr6U。

如果返回 JSON，通常格式如下：

{
  "errcode": "", // 通常成功时为空，错误则为错误码。
  "rs": 1, // 通常 1 表示成功，0 表示失败。
  "head": {
    "errCode": "00000000", // 错误码。
    "errInfo": "调用成功,没有任何错误", // 错误信息。
    "version": "2.4.0.2", // API 版本。
    ...
  },
  "body": {
    "externInfo": {
      "padding": ""
    },
    ...
  },
  ...
}

登录、注销。

• type 'login'（默认值）或 'logout'。
• username
• password
• mobile （用于手机验证登录，我们用不到，下同）
• code
• isValidation

返回值

• secret
• token
• avatar 头像 URL。
• uid
• userName

不要用这个，注册出来是成电新人。 考虑手工抓取 http://bbs.uestc.edu.cn/member.php?mod=register ，然后模拟表单提交；或者用 WebView 显示注册网页；或者自己写一个服务器端 API。

设置用户位置（与周边用户/帖子功能配合使用）。

• longitude 经度
• latitude 纬度
• location 地址

albumlist getsetting photolist report savealbum saveavatar setting topiclist updateuserinfo uploadavatar uploadavatarex useradmin useradminview userfavorite userinfo userinfoadminview userlist

• qqinfo
• qqlogin
• platforminfo
• saveplatforminfo
• saveqqinfo
• sign
• switch

获取版块列表。

• fid 可选。获取指定版块的子版块。
• type TODO: 待确认，但是我们可能用不到。

获取某一版块的主题列表。

• boardId 相当于 fid。
• page
• pageSize
• sortby 'publish' == 'new', 'essence' == 'marrow', 'top', 'photo', 'all'（默认）
• filterType 'sortid', 'typeid'
• filterId 分类 ID，只返回指定分类的主题。
• isImageList
• topOrder 0, 1（本版置顶）, 2（分类置顶）, 3（全局置顶）

获取帖子的回复列表。

• topicId
• authorId 只返回指定作者的回复，默认为 0 返回所有回复。
• order 0 或 1（回帖倒序排列）
• page
• pageSize

发帖/回复。

• act 'new'（发帖）、'reply'（回复）、其他字符串（编辑）
• json JSON 格式的发帖内容。

JSON 格式：

{
  "body": {
    "json": {
      "fid": 123, // 发帖时指定版块。
      "tid": 123456, // 回复时指定帖子。
      "typeOption": ...,
      "isAnonymous": 1, // 1 表示匿名发帖。
      "isOnlyAuthor": 1, // 1 表示回帖仅作者可见。
      "typeId": 1234, // 分类。
      "isQuote": 1, 是否引用之前回复的内容。
      "replyId": 123456, 回复 ID（pid）。
      "title": "Title", // 标题。
      "aid": "1,2,3", // 附件 ID，逗号隔开。
      "content": "又是一个 JSON 字符串，格式见下面。",
      "location": "TODO: 格式待确认"
    }
  }
}

body.json.content 格式：

[
  {
    "type": 0, // 0：文本（解析链接）；1：图片；3：音频
    "infor": "发帖内容|图片 URL|音频 URL"
  },
  ...
]

搜索（参数和 Discuz! search.php 一致）。

• keyword
• page
• pageSize
• searchid

发送附件（参数放在 URL 中）。

• attachment JSON 字符串。

JSON 格式：

{
  "body": {
    "attachment": {
      "module": "forum", // 默认为 forum，我们应该只用 forum。
      "type": 'audio', // audio, image, 
      "isPost": 1, // 通过 POST 请求正文发送。
    }
  }
}

发送附件的高级版本，可以将图片上传到相册。

• type 'image', 'audio'
• module 'forum', 'album', 'pm'
• albumId

投票。

• tid
• options 投票选项，逗号隔开。

对回复进行支持/反对操作。

• tid
• pid
• type 'topic'（默认）== 'thread', 'post'
• action 'support'（默认）, 'against'

站点公告。

• id

获取可以@的好友。（相当于河畔编辑器里单击@朋友后弹出的列表。）

• page
• pageSize

获取分类信息（目前河畔未使用）。

• sortid 分类信息 ID。

获取包含图片的帖子。

• page
• pageSize

评分记录查询。返回的 HTML。

• tid
• pid

活动帖参加、取消。

• tid
• act 'apply'（默认）, 'cancel'
• json JSON 字符串。

JSON 格式：

{
  "payment": , //支付的积分
  "message": , // 附加留言
  // 其他参数（活动时填写的信息）
}

参加活动。返回是 HTML。

• tid
• act

管理操作。返回 HTML。

• fid
• tid
• pid
• act
• type 'topic'（默认）

评分。返回 HTML。

• tid
• pid

查询新提醒数目（每隔一段时间查询）。

提醒列表。

• type 'post'（帖子）, 'at'（@消息）, 'friend'（好友？）
• page
• pageSize

短消息列表。 TODO: 貌似有点问题，只获取得到最新短消息。

• pmlist JSON 字符串。

JSON 格式：

{
  "body": {
    "externInfo": {
      "onlyFromUid": 0, // 只返回收到的消息（不包括自己发出去的消息）。
    },
    "pmInfos": {
      "startTime": , // 开始时间（以毫秒为单位）。startTime 和 stopTime 均为 0 表示获取最新（未读）消息。
      "stopTime": , // 结束时间（以毫秒为单位）。
      "cacheCount": ,
      "fromUid": 123, // UID，必须指定。
      "pmLimit": 10, // 最多返回几条结果，默认为 15。
    }
  }
}

短消息管理（发送、删除）。

• json

JSON 格式：

{
  "action": "send", // 'send'（默认）, 'delplid'（删除和某人的所有会话）, 'delpmid'
  "toUid": 12345, // send
  "msg": {
    "type": "text", // 'text', 'image', 'audio'
    "content": "消息内容（经过 URL 编码）/图片 URL/音频 URL"
  }, // send
  "plid": 123, // delplid（并非 uid）
  "pmid": 123  // delpmid
}

获取短消息会话列表。

• json 必选。

JSON 格式：

{
  "page": 1, // 可选，默认为 1。
  "pageSize": 10 // 可选，默认为 10。
}

获取周边用户/帖子。

• longitude 经度。
• latitude 纬度。
• poi 'user'（默认）或 'topic'。
• page
• pageSize
• radius 半径，单位为米（默认为 100000）。