豆瓣 API ( 解决104问题 )

心已赠人 2022-04-06 07:16 316阅读 0赞

## 图书 ##

--------------------

GET  https://api.douban.com/v2/book/search

<table> 
 <tbody> 
  <tr> 
   <td>参数</td> 
   <td>意义</td> 
   <td>备注</td> 
  </tr> 
  <tr> 
   <td>q</td> 
   <td>查询关键字</td> 
   <td>q和tag必传其一</td> 
  </tr> 
  <tr> 
   <td>tag</td> 
   <td>查询的tag</td> 
   <td>q和tag必传其一</td> 
  </tr> 
  <tr> 
   <td>start</td> 
   <td>取结果的offset</td> 
   <td>默认为0</td> 
  </tr> 
  <tr> 
   <td>count</td> 
   <td>取结果的条数</td> 
   <td>默认为20，最大为100</td> 
  </tr> 
 </tbody> 
</table>

{
          "start": 0,
          "count": 10,
          "total": 30,
          "books" : [Book, ]
    }

--------------------

### 获取图书信息 ###

--------------------

GET  https://api.douban.com/v2/book/:id

对于授权用户，返回数据中会带有该用户对该图书的收藏信息：

{
        … (图书信息的其他部分)
        "current_user_collection": {
            "status":"read",
            "rating": {
                "max":5,
                "value":"5",
                "min":0
            },
            "updated":"2012-11-2012:08:04",
            "user_id":"33388491",
            "book_id":"6548683",
            "id":605519800
        }
    }

--------------------

## 电影 ##

--------------------

*  **豆瓣热映      **https://api.douban.com/v2/movie/in\_theaters
 *  **即将上映**  [https://api.douban.com/v2/movie/coming\_soon][https_api.douban.com_v2_movie_coming_soon]
 *  **电影top250**  http://api.douban.com/v2/movie/top250
 *  **电影条目检索   **http://api.douban.com/v2/movie/search
 *  **条目详情        **http://api.douban.com/v2/movie/subject

参数：id（电影的id，数字类型）

如：电影《神秘巨星》http://api.douban.com/v2/movie/subject/26942674

*  **Example**:  `https://api.douban.com/v2/movie/search?q=张艺谋    `/v2/movie/search?tag=喜剧

**Request Properties:**

**Resources Properties:**

**Simple Subject Properties**

<table> 
 <thead> 
  <tr> 
   <th>Property</th> 
   <th>Description</th> 
   <th>Type</th> 
   <th>Basic</th> 
   <th>Advance</th> 
   <th>Premium</th> 
   <th>Default</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>id</td> 
   <td>条目id</td> 
   <td>str</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>-</td> 
  </tr> 
  <tr> 
   <td>title</td> 
   <td>中文名</td> 
   <td>str</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>-</td> 
  </tr> 
  <tr> 
   <td>original_title</td> 
   <td>原名</td> 
   <td>str</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>''</td> 
  </tr> 
  <tr> 
   <td>alt</td> 
   <td>条目URL</td> 
   <td>float(1)</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>-</td> 
  </tr> 
  <tr> 
   <td>images</td> 
   <td>电影海报图，分别提供288px x 465px(大)，96px x 155px(中) 64px x 103px(小)尺寸</td> 
   <td>dict</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>-</td> 
  </tr> 
  <tr> 
   <td>rating</td> 
   <td>评分</td> 
   <td>dict</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>-</td> 
  </tr> 
  <tr> 
   <td>pubdates</td> 
   <td>如果条目类型是电影则为上映日期，如果是电视剧则为首播日期</td> 
   <td>array</td> 
   <td>N</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>[]</td> 
  </tr> 
  <tr> 
   <td>year</td> 
   <td>年代</td> 
   <td>str</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>''</td> 
  </tr> 
  <tr> 
   <td>subtype</td> 
   <td>条目分类, movie或者tv</td> 
   <td>str</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>Y</td> 
   <td>movie<br> &nbsp;</td> 
  </tr> 
 </tbody> 
</table>

--------------------

## 获取音乐信息 ##

--------------------

GET  https://api.douban.com/v2/music/:id

**搜索音乐**

GET  https://api.douban.com/v2/music/search

[https://api.douban.com/v2/music/search?q=张韶涵&count=1][https_api.douban.com_v2_music_search_q_count_1]

[https://api.douban.com/v2/music/1403456][https_api.douban.com_v2_music_1403456]

[https://api.douban.com/v2/music/search?tag=日韩][https_api.douban.com_v2_music_search_tag]

{
          "start": 0,
          "count": 10,
          "total": 30,
          "musics" : [Music, ]
        }

--------------------

> **在微信小程序中，是无法访问的，可以使用https://douban.uieee.com来代替https://api.douban.com**
> 
> **或者使用nginx进行代理  [nginx代理豆瓣api-解决403][nginx_api-_403]**

--------------------

# **更新（2019-5-28）：** #

**最近api经常报错(报错信息)：**原因是没有添加apikey

{
        "msg": "invalid_apikey",
        "code": 104,
        "request": "GET /v2/movie/coming_soon"
    }

**解决：**

> 在参数中添加apikey：[https://api.douban.com/v2/movie/coming\_soon?apikey=0b2bdeda43b5688921839c8ecb20399b][https_api.douban.com_v2_movie_coming_soon_apikey_0b2bdeda43b5688921839c8ecb20399b]

[https_api.douban.com_v2_movie_coming_soon]: https://api.douban.com/v2/movie/coming_soon
[https_api.douban.com_v2_music_search_q_count_1]: https://api.douban.com/v2/music/search?q=%E5%BC%A0%E9%9F%B6%E6%B6%B5&count=1
[https_api.douban.com_v2_music_1403456]: https://api.douban.com/v2/music/1403456
[https_api.douban.com_v2_music_search_tag]: https://api.douban.com/v2/music/search?tag=%E6%97%A5%E9%9F%A9
[nginx_api-_403]: https://blog.csdn.net/qq_36157085/article/details/90632081
[https_api.douban.com_v2_movie_coming_soon_apikey_0b2bdeda43b5688921839c8ecb20399b]: https://api.douban.com/v2/movie/coming_soon?apikey=0b2bdeda43b5688921839c8ecb20399b