豆瓣 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>滿月之夜白鯨現(xiàn)</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年生于日本愛媛縣，九州大學農(nóng)學系農(nóng)業(yè)經(jīng)濟學專業(yè)畢業(yè)。
        學生時代通讀了包括夏目漱石和大江健三郎在內的日本近現(xiàn)代文學全集，
        同時讀了笛卡爾、萊布尼茨到結構主義的歐洲近現(xiàn)代哲學。也讀了馬克思。
        學士論文寫的是馬克思，碩士論文寫的是恩格斯。二十二三歲開始創(chuàng)作小說。
        代表作有《在世界中心呼喚愛》、《世界在你不知道的地方運轉》、《氣息》、
        《別相信約翰·列儂》、《滿月之夜白鯨現(xiàn)》、《空鏡頭》以及新作
        《倘若我在彼岸》、《雨天的海豚們》等。
    </db:attribute>
    <id>http://api.douban.com/book/subject/1220562</id>
    <gd:rating min="1" numRaters="39" average="3.69" max="5" />
</entry>通過請求中包括alt參數(shù)，你可以改變返回值的格式。 目前支持的alt參數(shù)值包括：

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":"滿月之夜白鯨現(xiàn)"},
    "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年生于日本愛媛縣，九州大學農(nóng)學系農(nóng)業(yè)經(jīng)濟學專業(yè)
        畢業(yè)。學生時代通讀了包括夏目漱石和大江健三郎在內的日本近現(xiàn)代文學全集，
        同時讀了笛卡爾、萊布尼茨到結構主義的歐洲近現(xiàn)代哲學。也讀了馬克思。
        學士論文寫的是馬克思，碩士論文寫的是恩格斯。二十二三歲開始創(chuàng)作小說。
        代表作有《在世界中心呼喚愛》、《世界在你不知道的地方運轉》、《氣息》、
        《別相信約翰·列儂》、《滿月之夜白鯨現(xiàn)》、《空鏡頭》以及新作《倘若我在
        彼岸》、《雨天的海豚們》等。","@name":"author-intro"}
    ],
    "id":{"$t":"http://api.douban.com/book/subject/1220562"},
    "gd:rating":{"@min":1,"@numRaters":39,"@average":"3.69","@max":5}
}