豆瓣 API 快速入門示例

楊竹青

下面通過(guò)一個(gè)簡(jiǎn)單的示例來(lái)演示豆瓣API的使用.

這個(gè)示例中展示了使用API獲得ID為1220562的書(shū)的信息, 請(qǐng)求的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="小說(shuō)" />
    <db:tag count="8" name="日本文學(xué)" />
    <db:tag count="4" name="愛(ài)情" />
    <title>滿月之夜白鯨現(xiàn)</title>
    <author>
        <name>（日）片山恭一</name>
    </author>
    <content>
        冷靜地想一想吧！公寓的一個(gè)房間里只有兩上人，連被褥都鋪好了，理應(yīng)是犯
        錯(cuò)誤的時(shí)候，我為什么卻這么拘謹(jǐn)？一直膽小的毛病又犯了。事到如今，不要
        說(shuō)上床，就連接吻也還差得很遠(yuǎn)。這就是橫亙?cè)谀腥撕团�人之間的又深又暗的
        河流嗎？
        如果有可能，我希望把手伸進(jìn)她的心里，把她內(nèi)心所有的東西都掏出來(lái)。她對(duì)
        我究竟是一種什么感覺(jué)呢？我在她的心昊確實(shí)占有一席之地嗎？抑或只是她生
        命中的匆匆過(guò)客？
    </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">平裝(無(wú)盤)</db:attribute>
    <db:attribute name="author-intro">
        片山恭一，1959年生于日本愛(ài)媛縣，九州大學(xué)農(nóng)學(xué)系農(nóng)業(yè)經(jīng)濟(jì)學(xué)專業(yè)畢業(yè)。
        學(xué)生時(shí)代通讀了包括夏目漱石和大江健三郎在內(nèi)的日本近現(xiàn)代文學(xué)全集，
        同時(shí)讀了笛卡爾、萊布尼茨到結(jié)構(gòu)主義的歐洲近現(xiàn)代哲學(xué)。也讀了馬克思。
        學(xué)士論文寫的是馬克思，碩士論文寫的是恩格斯。二十二三歲開(kāi)始創(chuàng)作小說(shuō)。
        代表作有《在世界中心呼喚愛(ài)》、《世界在你不知道的地方運(yùn)轉(zhuǎn)》、《氣息》、
        《別相信約翰·列儂》、《滿月之夜白鯨現(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>通過(guò)請(qǐng)求中包括alt參數(shù)，你可以改變返回值的格式。 目前支持的alt參數(shù)值包括：

atom (默認(rèn))
json

通過(guò)將alt設(shè)置為json來(lái)獲得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":"小說(shuō)"},
        {"@count":8,"@name":"日本文學(xué)"},
        {"@count":4,"@name":"愛(ài)情"}
    ],
    "title":{"$t":"滿月之夜白鯨現(xiàn)"},
    "author":[
        {"name":{"$t":"（日）片山恭一"}}
    ],
    "content":{"$t":"冷靜地想一想吧！公寓的一個(gè)房間里只有兩上人，連被褥都鋪
    好了，理應(yīng)是犯錯(cuò)誤的時(shí)候，我為什么卻這么拘謹(jǐn)？一直膽小的毛病又犯了。事到
    如今，不要說(shuō)上床，就連接吻也還差得很遠(yuǎn)。這就是橫亙?cè)谀腥撕团�人之間的又深
    又暗的河流嗎？\n    如果有可能，我希望把手伸進(jìn)她的心里，把她內(nèi)心所有的東
    西都掏出來(lái)。她對(duì)我究竟是一種什么感覺(jué)呢？我在她的心昊確實(shí)占有一席之地嗎？
    抑或只是她生命中的匆匆過(guò)客？"},
    "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":"平裝(無(wú)盤)","@name":"binding"},
        {"$t":"片山恭一，1959年生于日本愛(ài)媛縣，九州大學(xué)農(nóng)學(xué)系農(nóng)業(yè)經(jīng)濟(jì)學(xué)專業(yè)
        畢業(yè)。學(xué)生時(shí)代通讀了包括夏目漱石和大江健三郎在內(nèi)的日本近現(xiàn)代文學(xué)全集，
        同時(shí)讀了笛卡爾、萊布尼茨到結(jié)構(gòu)主義的歐洲近現(xiàn)代哲學(xué)。也讀了馬克思。
        學(xué)士論文寫的是馬克思，碩士論文寫的是恩格斯。二十二三歲開(kāi)始創(chuàng)作小說(shuō)。
        代表作有《在世界中心呼喚愛(ài)》、《世界在你不知道的地方運(yùn)轉(zhuǎn)》、《氣息》、
        《別相信約翰·列儂》、《滿月之夜白鯨現(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}
}