豆瓣API测试控制台

豆瓣 API 测试控制台的创造灵感来源于 Facebook Developers Tools 中的 Facebook API Console, 或许大家知道,魔豆是我的另外一个豆瓣 API 应用,由于是自己封装的 Douban API(官方提供的库类要求太多,安装繁琐,这不属于我喜爱简洁,轻便的风格),每次想查看某个 API 接口返回的数据都要写一个 test 跑一下。 麻烦不说,还容易出错,于是,使用自己封装的 Douban API,借鉴 Facebook API Console 的界面和类似的功能显示,终于小有所成,其中为了实现此控制台,封包的库类经过两次大改,虽然改的很辛苦, 但从中学到了很多开发经验。

测试用户必须先进行用户验证才能进行测试,这主要是为了:

  1. 避免提交查询中出现错误,并让测试者使用到全部API方法
  2. 防止恶意用户利用它做二次api调用,由于测试控制台的传输很简单,提交参数即可查询。

查询方法:

  1. 进行用户的登录验证
  2. 选择返回的数据类型(支持官方提供的 XML 和 JSON格式)
  3. 选择需要查询的API方法(这里我做了分类)
  4. 如果查询的方法存在参数,会在方法下面显示。
  5. 设置完毕参数后,点击“调用此方法”,稍等片刻即可。

返回的数据结果会在右侧显示出来,其中,右上部分是调用相关 API 的 URL 地址;右下部分是返回的数据结果。

如果,参数设置错误,或者其他问题,返回的结果会以 [CODE] Content 的格式返回,其中 CODE 代码返回的状态码, Content 是返回的信息。

通用参数解释:

  • id  - 查询方法涉及到的 id 值(人,书影音,日记,广播,豆邮,同城等)
  • message - 广播发送的内容
  • title - 日记,豆邮的标题
  • content - 主题内容
  • city - 同城活动的城市代号(根据我判断,应该是中文的拼音,详细请看官方同城列表中各个城市的url)
  • query - 搜索的关键字
  • index - 返回多个元素时,起始元素的下标(相当于豆瓣 api 文档中的start-index)
  • max - 返回多个entry时,每页最多的结果数(相当于豆瓣 api 文档中的max-results)

其中某些方法(涉及到自身的数据,比如我的信息,我的广播,我的同城)在进行查询的时候可以把 id 留空或者设置为 ‘me’ (不带引号),这样调用结果显示的是自己的信息。

如果长时间(大于1分钟)处于“调用中”,可能是由于程序问题,请刷新后重试。

已知存在的问题:

  1. 界面和方法列表在 Chrome 浏览器有不兼容的问题出现
  2. 返回数据结果头一行多出一个类似水平制表符的转义符似的

由于目前为止豆瓣 API 还没有封装完成,现只提供用户,广播,书影音,豆邮和日记的不完全功能测试查询。 其余的 API 会尽快添加进去 :)

测试地址:http://modou.us/console

This entry was posted in Kohana, 网络开发 and tagged , , , , . Bookmark the permalink.

One Response to 豆瓣API测试控制台

  1. zhonggao says:

    看了您的kohana的中文论坛,您为什么把论坛弄的一点都不像一个技术论坛,倒是蛮像毛片论坛的,做了那些个限制,看附件要回帖,请问这是技术论坛么,难道您不是想让它发扬光大,让更多的人方便学习,让更多人了解知道您的论坛么?真不懂您是怎么处心积虑的,就难道没想想即使给你回帖了,你看看都是回什么内容的,有意义么,反而倒是有人对该帖做建设性讨论的时候,到处都看到的是垃圾回复。
    还有注册,整那么麻烦干嘛啊,还的多输入个您的网址,弄的也没有说明,有悖于常人习惯,难道您是怕人注册么,如此封闭,您这个论坛本来能火,能有影响力,看来也会被你自己抹杀的。

Leave a Reply

Your email address will not be published. Required fields are marked *

*

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>