Skip to content
方觉 edited this page Jul 24, 2015 · 32 revisions

API 请求 URL

http://bbs.uestc.edu.cn/mobcent/app/web/index.php?r=命令 (命令为 xxx/yyy 格式,见下面)

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

公用参数

accessToken 和 accessSecret

用户登录后的认证参数。

apphash

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

sdkVersion

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 没什么关系。

forumKey

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

user

user/login

登录、注销。

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

user/register

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

user/location

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

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

TODO

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

其他 user API

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

forum

forum/forumlist

获取版块列表。

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

forum/topiclist

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

  • boardId 相当于 fid。
  • page
  • pageSize
  • sortby 'publish' == 'new', 'essence' == 'marrow', 'top', 'photo', 'all'(默认)
  • filterType 'sortid', 'typeid'
  • filterId
  • isImageList
  • topOrder 0, 1(本版置顶), 2(分类置顶), 3(全局置顶)

TODO: sortid 待确认。

forum/postlist

获取帖子的回复列表。

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

forum/topicadmin

发帖/回复。

  • 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"
  },
  ...
]

forum/search

搜索(参数和 Discuz! search.php 一致)。

  • keyword
  • page
  • pageSize
  • searchid

forum/sendattachment

发送附件(参数放在 URL 中)。

  • attachment JSON 字符串。

JSON 格式:

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

forum/sendattachmentex

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

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

forum/vote

投票。

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

forum/support

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

  • tid
  • pid
  • type 'topic'(默认)== 'thread', 'post'
  • action 'support'(默认), 'against'

forum/announcement

站点公告。

  • id

forum/atuserlist

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

  • page
  • pageSize

forum/classification

TODO: ???

  • sortid

forum/photogallery

获取包含图片的帖子。

  • page
  • pageSize

forum/ratelistview

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

  • tid
  • pid

forum/topicactivity

活动帖参加、取消。

  • tid
  • act 'apply'(默认), 'cancel'
  • json JSON 字符串。

JSON 格式:

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

forum/topicactivityview

参加活动。返回是 HTML

  • tid
  • act

forum/topicadminview

管理操作。返回 HTML

  • fid
  • tid
  • pid
  • act
  • type 'topic'(默认)

forum/topicrate

评分。返回 HTML。

  • tid
  • pid

message

message/heart

查询新提醒数目(每隔一段时间查询)。

message/notifylist

提醒列表。

  • type 'post'(帖子), 'at'(@消息), 'friend'(好友?)
  • page
  • pageSize

message/pmlist

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

  • pmlist JSON 字符串。

JSON 格式:

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

message/pmadmin

短消息管理(发送、删除)。

  • 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
}

message/pmsessionlist

获取短消息会话列表。

  • json 必选。

JSON 格式:

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

square

square/surrounding

获取周边用户/帖子。

  • longitude 经度。
  • latitude 纬度。
  • poi 'user'(默认)或 'topic'。
  • page
  • pageSize
  • radius 半径,单位为米(默认为 100000)。
Clone this wiki locally