add user_bookmarks_novel (#284)

* add user_bookmarks_novel

* fix comments

README.md

@@ -211,6 +211,9 @@ class AppPixivAPI(BasePixivAPI):
     # tag: 从 user_bookmark_tags_illust 获取的收藏标签
     def user_bookmarks_illust(user_id, restrict="public"):
 
+    # 用户收藏作品列表中的小说
+    def user_bookmarks_novel(user_id, restrict="public"):
+
     def user_related(seed_user_id):
 
     # 关注用户的新作
@@ -362,6 +365,12 @@ print(json_result)
 illust = json_result.illusts[0]
 print(">>> %s, origin url: %s" % (illust.title, illust.image_urls['large']))
 
+# 用户收藏列表中的小说
+json_result = aapi.user_bookmarks_novel(42862448)
+print(json_result)
+novel = json_result.novels[0]
+print(">>> {}, text_length: {}, series: {}".format(novel.title, novel.text_length, novel.series))
+
 # 2016-07-15 日的过去一周排行
 json_result = aapi.illust_ranking('week', date='2016-07-15')
 print(json_result)

demo.py

@@ -93,6 +93,11 @@ def appapi_users(aapi):
     illust = json_result.illusts[0]
     print(">>> {}, origin url: {}".format(illust.title, illust.image_urls["large"]))
 
+    json_result = aapi.user_bookmarks_novel(42862448)
+    print(json_result)
+    novel = json_result.novels[0]
+    print(">>> {}, text_length: {}, series: {}".format(novel.title, novel.text_length, novel.series))
+
     json_result = aapi.user_following(7314824)
     print(json_result)
     user_preview = json_result.user_previews[0]

pixivpy3/aapi.py

@@ -185,6 +185,29 @@ def user_bookmarks_illust(
         r = self.no_auth_requests_call("GET", url, params=params, req_auth=req_auth)
         return self.parse_result(r)
 
+    # 用户收藏小说列表
+    def user_bookmarks_novel(
+        self,
+        user_id: int | str,
+        restrict: _RESTRICT = "public",
+        filter: _FILTER = "for_ios",
+        max_bookmark_id: int | str | None = None,
+        tag: str | None = None,
+        req_auth: bool = True,
+    ) -> ParsedJson:
+        url = "%s/v1/user/bookmarks/novel" % self.hosts
+        params = {
+            "user_id": user_id,
+            "restrict": restrict,
+            "filter": filter,
+        }
+        if max_bookmark_id:
+            params["max_bookmark_id"] = max_bookmark_id
+        if tag:
+            params["tag"] = tag
+        r = self.no_auth_requests_call("GET", url, params=params, req_auth=req_auth)
+        return self.parse_result(r)
+
     def user_related(
         self,
         seed_user_id: int | str,