如何调用豆瓣API

29 January 2014

　　最近在自己的网页中希望可以输入书籍的ISBN号就可以自动补全书籍的所有信息，人工输入工作量太大，就选择了调用豆瓣的API获得数据填写到表单中。做了两天才做好，网上有用的资料比较少，于是晒出自己这两天做的一些东西，希望可以帮助到需要的人，注意：APIV1.0和2.0是有区别的。在下面有提到，需要稍微留意。
　　下面的代码实现的功能都是将ISBN号为9787543632608（片山恭一的《满月之夜白鲸现》）的图书信息返回出来，只是使用的方法不一样而已，运行的结果如下图,贴html代码似乎有点问题（已解决，参见文章末解决办法），还没找到解决办法，只能先转成图片上传，代码点击这里：

1. JS调用

　　通过豆瓣js中的函数来获得图书的信息。JS文件采用的是豆瓣的apiV2.0，不过返回出来结果和旧版的apiV1.0一样，返回的信息不是JSON格式，需要调用parseSubject函数来转为JSON对象。代码如下：

2. JQuery调用

　　替换上面代码的script标签里面的内容。getJSON函数的第一个参数为url，第二个为回调函数，即获取url的JSON数据之后执行的函数，这个url是老版本的apiV1.0，所以同上面一样，还是要调用parseSubject函数。

　　如果采用的是APIV2.0版，有些不同，首先getJSON函数url参数是新版的url，返回出来的数据格式就是JSON格式，不需要转换直接使用即可。有个问题，除了book.author可以加上.join(‘ / ‘)加上分隔符，其他参数加上这个函数就会出错，不知道什么原因。

##附：JSON格式 ## 　　关于JSON格式，这个是在网上看到阮一峰老师写的博客的，写的很好，一下子就理解了。

　　从结构上看，所有的数据（data）最终都可以分解成三种类型：
　　第一种类型是标量（scalar），也就是一个单独的字符串（string）或数字（numbers），比如”北京”这个单独的词。
　　第二种类型是序列（sequence），也就是若干个相关的数据按照一定顺序并列在一起，又叫做数组（array）或列表（List），比如”北京，上海”。
　　第三种类型是映射（mapping），也就是一个名/值对（Name/value），即数据有一个名称，还有一个与之相对应的值，这又称作散列（hash）或字典（dictionary），比如”首都：北京”。
　　21世纪初，Douglas Crockford寻找一种简便的数据交换格式，能够在服务器之间交换数据。当时通用的数据交换语言是XML，但是Douglas Crockford觉得XML的生成和解析都太麻烦，所以他提出了一种简化格式，也就是Json。
　　Json的规格非常简单，只用一个页面几百个字就能说清楚，而且Douglas Crockford声称这个规格永远不必升级，因为该规定的都规定了。
　　1）并列的数据之间用逗号（”, “）分隔。
　　2）映射用冒号（”: “）表示。
　　3）并列数据的集合（数组）用方括号(“[]”)表示。
　　4）映射的集合（对象）用大括号（”{}”）表示。
　　上面四条规则，就是Json格式的所有内容。

jekyll中的不能嵌套html代码

之前不能在markdown文件中嵌入html代码，在build的时候总会出问题，貌似是转义字符的问题，现在可以了，解决方法是使用RDiscount模板解释器替代Maruku。这个解释器到底是干嘛用的呢？和其它轻量标记语言一样，Markdown并不能也不旨在替代HTML；因为所有的网页最终都要交给浏览器来解析的，而浏览器只认识HTML，因此，单独使用Markdown编写的文本并不能为浏览器所认识；所以，在浏览器和Markdown之间还要有一个东西，那就是翻译器。它将已完成的Markdown格式的文本转换成HTML文本，然后才能交由浏览器来解析和排版。Markdown官方发布的翻译器是一个Perl脚本，在命令行执行如下命令即可转换Markdown文本到HTML文本：

perl Markdown.pl --html4tags sample.txt > sample.html

Maruku是纯ruby的Markdown模版解释器；RDiscount则是c写的模版解释器，两者的效率显然不同。RDiscount的安装很简单：

gem install RDiscount

再修改下_config.yml文件，加上：

markdown: rdiscount 再运行`jekyll build`和`jekyll server`就不会有错误了。