豆瓣 API 快速入门示例

杨竹青

下面通过一个简单的示例来演示豆瓣API的使用.

这个示例中展示了使用API获得ID为1220562的书的信息, 请求的url如下（注意将{yourapikey}替换为你的API Key）

http://api.douban.com/book/subject/1220562?apikey={yourkeyapi}返回值为XML文档

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom"
    xmlns:gd="http://schemas.google.com/g/2005"
    xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/"
    xmlns:db="http://www.douban.com/xmlns/">
    <category scheme="http://www.douban.com/2007#kind"
        term="http://www.douban.com/2007#book" />
    <db:tag count="20" name="片山恭一" />
    <db:tag count="14" name="日本" />
    <db:tag count="10" name="小说" />
    <db:tag count="8" name="日本文学" />
    <db:tag count="4" name="爱情" />
    <title>满月之夜白鲸现</title>
    <author>
        <name>（日）片山恭一</name>
    </author>
    <content>
        冷静地想一想吧！公寓的一个房间里只有两上人，连被褥都铺好了，理应是犯
        错误的时候，我为什么却这么拘谨？一直胆小的毛病又犯了。事到如今，不要
        说上床，就连接吻也还差得很远。这就是横亘在男人和女人之间的又深又暗的
        河流吗？
        如果有可能，我希望把手伸进她的心里，把她内心所有的东西都掏出来。她对
        我究竟是一种什么感觉呢？我在她的心昊确实占有一席之地吗？抑或只是她生
        命中的匆匆过客？
    </content>
    <link rel="self" href="http://api.douban.com/book/subject/1220562" />
    <link rel="alternate" href="http://www.douban.com/subject/1220562/" />
    <link rel="image" href="http://otho.douban.com/spic/s1747553.jpg" />
    <db:attribute name="author">（日）片山恭一</db:attribute>
    <db:attribute name="isbn10">7543632608</db:attribute>
    <db:attribute name="isbn13">9787543632608</db:attribute>
    <db:attribute name="pages">180</db:attribute>
    <db:attribute name="tranlator">豫人</db:attribute>
    <db:attribute name="price">18.00</db:attribute>
    <db:attribute name="publisher">青岛出版社</db:attribute>
    <db:attribute name="binding">平装(无盘)</db:attribute>
    <db:attribute name="author-intro">
        片山恭一，1959年生于日本爱媛县，九州大学农学系农业经济学专业毕业。
        学生时代通读了包括夏目漱石和大江健三郎在内的日本近现代文学全集，
        同时读了笛卡尔、莱布尼茨到结构主义的欧洲近现代哲学。也读了马克思。
        学士论文写的是马克思，硕士论文写的是恩格斯。二十二三岁开始创作小说。
        代表作有《在世界中心呼唤爱》、《世界在你不知道的地方运转》、《气息》、
        《别相信约翰·列侬》、《满月之夜白鲸现》、《空镜头》以及新作
        《倘若我在彼岸》、《雨天的海豚们》等。
    </db:attribute>
    <id>http://api.douban.com/book/subject/1220562</id>
    <gd:rating min="1" numRaters="39" average="3.69" max="5" />
</entry>通过请求中包括alt参数，你可以改变返回值的格式。 目前支持的alt参数值包括：

atom (默认)
json

通过将alt设置为json来获得json格式的返回值:

{"category":{
    "@scheme":"http://www.douban.com/2007#kind",
    "@term":"http://www.douban.com/2007#book"},
    "db:tag":[
        {"@count":20,"@name":"片山恭一"},
        {"@count":14,"@name":"日本"},
        {"@count":10,"@name":"小说"},
        {"@count":8,"@name":"日本文学"},
        {"@count":4,"@name":"爱情"}
    ],
    "title":{"$t":"满月之夜白鲸现"},
    "author":[
        {"name":{"$t":"（日）片山恭一"}}
    ],
    "content":{"$t":"冷静地想一想吧！公寓的一个房间里只有两上人，连被褥都铺
    好了，理应是犯错误的时候，我为什么却这么拘谨？一直胆小的毛病又犯了。事到
    如今，不要说上床，就连接吻也还差得很远。这就是横亘在男人和女人之间的又深
    又暗的河流吗？\n    如果有可能，我希望把手伸进她的心里，把她内心所有的东
    西都掏出来。她对我究竟是一种什么感觉呢？我在她的心昊确实占有一席之地吗？
    抑或只是她生命中的匆匆过客？"},
    "link":[
        {"@rel":"self","@href":"http://api.douban.com/book/subject/1220562"},
        {"@rel":"alternate","@href":"http://www.douban.com/subject/1220562/"},
        {"@rel":"image","@href":"http://otho.douban.com/spic/s1747553.jpg"}
    ],
    "db:attribute":[
        {"$t":"（日）片山恭一","@name":"author"},
        {"$t":"7543632608","@name":"isbn10"},
        {"$t":"9787543632608","@name":"isbn13"},
        {"$t":"180","@name":"pages"},
        {"$t":"豫人","@name":"tranlator"},
        {"$t":"18.00","@name":"price"},
        {"$t":"青岛出版社","@name":"publisher"},
        {"$t":"平装(无盘)","@name":"binding"},
        {"$t":"片山恭一，1959年生于日本爱媛县，九州大学农学系农业经济学专业
        毕业。学生时代通读了包括夏目漱石和大江健三郎在内的日本近现代文学全集，
        同时读了笛卡尔、莱布尼茨到结构主义的欧洲近现代哲学。也读了马克思。
        学士论文写的是马克思，硕士论文写的是恩格斯。二十二三岁开始创作小说。
        代表作有《在世界中心呼唤爱》、《世界在你不知道的地方运转》、《气息》、
        《别相信约翰·列侬》、《满月之夜白鲸现》、《空镜头》以及新作《倘若我在
        彼岸》、《雨天的海豚们》等。","@name":"author-intro"}
    ],
    "id":{"$t":"http://api.douban.com/book/subject/1220562"},
    "gd:rating":{"@min":1,"@numRaters":39,"@average":"3.69","@max":5}
}