qqmusic-api-python 0.1.7__tar.gz → 0.1.8__tar.gz

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: qqmusic-api-python
-Version: 0.1.7
+Version: 0.1.8
 Summary: QQ音乐API封装库
 Keywords: music,api,qqmusic,tencentmusic
 Home-page: https://github.com/luren-dc/QQMusicApi
@@ -20,7 +20,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Project-URL: Homepage, https://github.com/luren-dc/QQMusicApi
 Project-URL: Repository, https://github.com/luren-dc/QQMusicApi
 Project-URL: Documentation, https://github.com/luren-dc/QQMusicApi
-Requires-Python: <4.0,>=3.9
+Requires-Python: <3.13,>=3.9
 Requires-Dist: cryptography<42.0.0,>=41.0.2
 Requires-Dist: typing-extensions>=4.12.2
 Requires-Dist: httpx>=0.27.0
@@ -30,7 +30,7 @@ Description-Content-Type: text/markdown
     <h1> QQMusicApi </h1>
     <p> Python QQ音乐 API 封装库 </p>
     <a href="https://www.python.org">
-        <img src="https://img.shields.io/badge/python-3.9+-blue" alt="Python">
+        <img src="https://img.shields.io/badge/python-3.9|3.10|3.11|3.12-blue" alt="Python">
     </a>
     <a href="https://github.com/astral-sh/ruff">
         <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
@@ -101,9 +101,15 @@ asyncio.run(main())
 
 ## 参考项目
 
-- [Rain120/qq-muisc-api](https://github.com/Rain120/qq-music-api)
-- [jsososo/QQMusicApi](https://github.com/jsososo/QQMusicApi)
-- [Nemo2011/bilibili-api](https://github.com/Nemo2011/bilibili-api/)
+### API
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Rain120&repo=qq-music-api)](https://github.com/Rain120/qq-music-api)
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=jsososo&repo=QQMusicApi)](https://github.com/jsososo/QQMusicApi)
+
+### QRC 解密
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=chenmozhijin&repo=LDDC)](https://github.com/chenmozhijin/LDDC)
+
+### 项目架构
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Nemo2011&repo=bilibili-api)](https://github.com/Nemo2011/bilibili-api)
 
 ## Licence
 

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.8}/README.md

@@ -2,7 +2,7 @@
     <h1> QQMusicApi </h1>
     <p> Python QQ音乐 API 封装库 </p>
     <a href="https://www.python.org">
-        <img src="https://img.shields.io/badge/python-3.9+-blue" alt="Python">
+        <img src="https://img.shields.io/badge/python-3.9|3.10|3.11|3.12-blue" alt="Python">
     </a>
     <a href="https://github.com/astral-sh/ruff">
         <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
@@ -73,9 +73,15 @@ asyncio.run(main())
 
 ## 参考项目
 
-- [Rain120/qq-muisc-api](https://github.com/Rain120/qq-music-api)
-- [jsososo/QQMusicApi](https://github.com/jsososo/QQMusicApi)
-- [Nemo2011/bilibili-api](https://github.com/Nemo2011/bilibili-api/)
+### API
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Rain120&repo=qq-music-api)](https://github.com/Rain120/qq-music-api)
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=jsososo&repo=QQMusicApi)](https://github.com/jsososo/QQMusicApi)
+
+### QRC 解密
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=chenmozhijin&repo=LDDC)](https://github.com/chenmozhijin/LDDC)
+
+### 项目架构
+[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=Nemo2011&repo=bilibili-api)](https://github.com/Nemo2011/bilibili-api)
 
 ## Licence
 

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.8}/pyproject.toml

@@ -15,7 +15,7 @@ dependencies = [
     "typing-extensions>=4.12.2",
     "httpx>=0.27.0",
 ]
-requires-python = "<4.0,>=3.9"
+requires-python = "<3.13,>=3.9"
 readme = "README.md"
 maintainers = [
     { name = "Luren", email = "68656403+luren-dc@users.noreply.github.com" },
@@ -39,7 +39,7 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dynamic = []
-version = "0.1.7"
+version = "0.1.8"
 
 [project.license]
 text = "MIT"
@@ -69,6 +69,8 @@ docs = [
     "mkdocs>=1.6.0",
     "markdown-callouts>=0.4.0",
     "griffe-inherited-docstrings>=1.0.0",
+    "docstring-inheritance>=2.2.1",
+    "griffe-modernized-annotations>=1.0.8",
 ]
 mypy = [
     "mypy>=1.11.0",
@@ -143,3 +145,4 @@ testpaths = [
     "tests",
 ]
 asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.8}/qqmusic_api/__init__.py

@@ -1,9 +1,9 @@
-from . import album, login, lyric, mv, search, singer, song, songlist, top
+from . import album, login, lyric, mv, search, singer, song, songlist, top, user
 from .utils.credential import Credential
 from .utils.network import get_session, set_session
 from .utils.sync import sync
 
-__version__ = "0.1.7"
+__version__ = "0.1.8"
 
 __all__ = [
     "album",
@@ -19,4 +19,5 @@ __all__ = [
     "songlist",
     "sync",
     "top",
+    "user",
 ]

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.8}/qqmusic_api/album.py

@@ -33,8 +33,8 @@ class Album:
         """
         if mid is None and id is None:
             raise ValueError("mid or id must be provided")
-        self.mid = mid
-        self.id = id
+        self.mid = mid or ""
+        self.id = id or 0
         self._info: Optional[dict] = None
 
     async def get_mid(self) -> str:
@@ -43,7 +43,9 @@ class Album:
         Returns:
             专辑 mid
         """
-        return (await self.get_detail())["basicInfo"]["albumMid"]
+        if not self.mid:
+            self.mid = (await self.get_detail())["basicInfo"]["albumMid"]
+        return self.mid
 
     async def get_id(self) -> int:
         """获取专辑 id
@@ -51,7 +53,9 @@ class Album:
         Returns:
             专辑 id
         """
-        return (await self.get_detail())["basicInfo"]["albumID"]
+        if not self.id:
+            self.id = (await self.get_detail())["basicInfo"]["albumID"]
+        return self.id
 
     async def get_detail(self) -> dict:
         """获取专辑详细信息

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.8}/qqmusic_api/data/api/login.json

@@ -6,7 +6,8 @@
             "code": "str 鉴权码",
             "musicid": "int",
             "musickey": "str",
-            "refresh_key": "str"
+            "refresh_key": "str",
+            "refresh_token": "str"
         },
         "extra_common": {
             "tmeLoginType": "str 2"
@@ -19,9 +20,10 @@
         "params": {
             "strAppid": "wx48db31d50e334801",
             "code": "str 鉴权码",
-            "str_musicid": "str",
+            "musicid": "int",
             "musickey": "str",
             "refresh_key": "str",
+            "refresh_token": "str",
             "loginMode": "int 2"
         },
         "extra_common": {
@@ -32,6 +34,7 @@
     "send_authcode": {
         "module": "music.login.LoginServer",
         "method": "SendPhoneAuthCode",
+        "ignore_code": true,
         "params": {
             "tmeAppid": "qqmusic",
             "phoneNo": "str 手机号",
@@ -45,14 +48,23 @@
     "phone_login": {
         "module": "music.login.LoginServer",
         "method": "Login",
+        "ignore_code": true,
         "params": {
             "code": "str 验证码",
             "phoneNo": "str 手机号",
             "loginMode": "int 1"
         },
         "extra_common": {
-            "tmeLoginMethod": "str 3"
+            "tmeLoginMethod": "str 3",
+            "tmeLoginType": "str 0"
         },
-        "comment": "发送验证码"
+        "comment": "手机验证码鉴权"
+    },
+    "check_expired": {
+        "module": "music.UserInfo.userInfoServer",
+        "method": "GetLoginUserInfo",
+        "verify": true,
+        "params": {},
+        "comment": "获取登录用户的信息，用于检测凭证是否失效"
     }
 }

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.8}/qqmusic_api/data/api/search.json

@@ -8,7 +8,7 @@
         "comment": "获取热搜词"
     },
     "complete": {
-        "module": "tencent_music_soso_smartbox_cgi.SmartBoxCgi",
+        "module": "music.smartboxCgi.SmartBoxCgi",
         "method": "GetSmartBoxResult",
         "params": {
             "search_id": "int 随机生成",
@@ -21,10 +21,11 @@
     "quick_search": {
         "url": "https://c.y.qq.com/splcloud/fcgi-bin/smartbox_new.fcg",
         "method": "GET",
+        "platform": "web",
         "params": {
             "key": "str 搜索词"
         },
-        "comment": "桌面端快速搜索"
+        "comment": "快速搜索"
     },
     "general_search": {
         "module": "music.adaptor.SearchAdaptor",
@@ -43,6 +44,7 @@
     "desktop_search_by_type": {
         "module": "music.search.SearchCgiService",
         "method": "DoSearchForQQMusicDesktop",
+        "platform": "desktop",
         "params": {
             "search_id": "int 随机生成",
             "search_type": "int 搜索类型",

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.8}/qqmusic_api/data/api/song.json

@@ -68,7 +68,8 @@
         "module": "music.mir.SheetMusicSvr",
         "method": "GetMoreSheetMusic",
         "params": {
-            "songmid": "str 歌曲 mid"
+            "songmid": "str 歌曲 mid",
+            "scoreType": "int -1"
         },
         "comment": "获取相关曲谱"
     },

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.8}/qqmusic_api/data/api/songlist.json

@@ -1,6 +1,6 @@
 {
     "detail": {
-        "module": "srf_diss_info.DissInfoServer",
+        "module": "music.srfDissInfo.DissInfo",
         "method": "CgiGetDiss",
         "params": {
             "disstid": "int 歌单ID",
@@ -9,9 +9,9 @@
             "onlysonglist": "int 是否只返回歌曲",
             "song_begin": "int 开始位置",
             "song_num": "int 返回数量",
-            "userinfo": "int 是否返回以后信息",
+            "userinfo": "int 是否返回用户信息",
             "orderlist": "int 是否排序歌单",
-            "caller": "str musicid"
+            "enc_host_uin": "str encrypt_uin"
         }
     }
 }

qqmusic_api_python-0.1.8/qqmusic_api/data/api/user.json

@@ -0,0 +1,171 @@
+{
+    "profile": {
+        "url": "https://c6.y.qq.com/rsc/fcgi-bin/fcg_get_profile_homepage.fcg",
+        "method": "GET",
+        "platform": "web",
+        "headers": {
+            "referer": "https://y.qq.com/"
+        },
+        "params": {
+            "ct": "int 20",
+            "cv": "int 4747474",
+            "cid": "int 205360838",
+            "userid": "str musicid or euin"
+        },
+        "comment": "获取用户主页，根据 cookie 值不同，内容有差异"
+    },
+    "vip_info": {
+        "module": "VipLogin.VipLoginInter",
+        "method": "vip_login_base",
+        "verify": true,
+        "params": {},
+        "comment": "获取当前登录账号的 vip 信息"
+    },
+    "homepage": {
+        "module": "music.UnifiedHomepage.UnifiedHomepageSrv",
+        "method": "GetHomepageHeader",
+        "params": {
+            "uin": "str musicid or euin",
+            "IsQueryTabDetail": "int 1"
+        },
+        "comment": "获取用户主页信息(包含用户信息，音乐基因，乐库，用户歌单等信息)，根据 cookie 值不同，内容有差异"
+    },
+    "friend": {
+        "module": "music.homepage.Friendship",
+        "method": "GetFriendList",
+        "verify": true,
+        "params": {
+            "Page": "int 页数",
+            "PageSize": "int 每页数量"
+        },
+        "comment": "获取好友列表"
+    },
+    "songlist_by_euin": {
+        "url": "https://c6.y.qq.com/rsc/fcgi-bin/fcg_user_created_diss",
+        "method": "GET",
+        "platform": "web",
+        "headers": {
+            "referer": "https://y.qq.com/"
+        },
+        "params": {
+            "hostuin": "str encrypt_uin",
+            "sin": "int 页数",
+            "size": "int 每页返回数量"
+        },
+        "comment": "通过 encrypt_uin 获取用户歌单列表"
+    },
+    "songlist_by_uin": {
+        "module": "music.musicasset.PlaylistBaseRead",
+        "method": "GetPlaylistByUin",
+        "platform": "desktop",
+        "params": {
+            "uin": "str uin"
+        },
+        "comment": "通过 uin 获取用户歌单列表"
+    },
+    "follow_singer": {
+        "module": "music.concern.RelationList",
+        "method": "GetFollowSingerList",
+        "verify": true,
+        "params": {
+            "From": "int 起始序号",
+            "Size": "int 返回数量",
+            "HostUin": "str encrypt_uin"
+        },
+        "comment": "获取关注歌手列表"
+    },
+    "follow_user": {
+        "module": "music.concern.RelationList",
+        "method": "GetFollowUserList",
+        "verify": true,
+        "params": {
+            "From": "int 起始序号",
+            "Size": "int 返回数量",
+            "HostUin": "str encrypt_uin"
+        },
+        "comment": "获取关注用户列表"
+    },
+    "fans": {
+        "module": "music.concern.RelationList",
+        "method": "GetFansList",
+        "verify": true,
+        "params": {
+            "From": "int 起始序号",
+            "Size": "int 返回数量",
+            "HostUin": "str encrypt_uin"
+        },
+        "comment": "获取粉丝列表"
+    },
+    "fav_songlist_self": {
+        "module": "music.mobileAsset.GetFav",
+        "method": "CgiGetOrderDiss",
+        "verify": true,
+        "params": {},
+        "comment": "获取当前登录用户收藏歌单"
+    },
+    "fav_album_self": {
+        "module": "music.mobileAsset.GetFav",
+        "method": "CgiGetOrderAlbum",
+        "verify": true,
+        "params": {},
+        "comment": "获取当前登录用户收藏专辑"
+    },
+    "fav_mv_self": {
+        "module": "music.mobileAsset.GetFav",
+        "method": "CgiGetOrderMV",
+        "verify": true,
+        "params": {},
+        "comment": "获取当前登录用户收藏MV"
+    },
+    "fav_songlist_by_euin": {
+        "module": "music.musicasset.PlaylistFavRead",
+        "method": "CgiGetPlaylistFavInfo",
+        "params": {
+            "uin": "str encrypt_uin",
+            "offset": "int 偏移量",
+            "size": "int 返回数量"
+        },
+        "comment": "通过 encrypt_uin 获取收藏歌单"
+    },
+    "fav_album_by_euin": {
+        "module": "music.musicasset.AlbumFavRead",
+        "method": "CgiGetAlbumFavInfo",
+        "params": {
+            "euin": "str encrypt_uin",
+            "offset": "int 偏移量",
+            "size": "int 返回数量"
+        },
+        "comment": "通过 encrypt_uin 获取收藏专辑"
+    },
+    "fav_mv": {
+        "module": "music.musicasset.MVFavRead",
+        "method": "getMyFavMV",
+        "verify": true,
+        "params": {
+            "uin": "str musicid or euin",
+            "support": "int 1",
+            "req_icon_type": "int 1"
+        },
+        "comment": "获取收藏 MV"
+    },
+    "fav_mv_by_euin": {
+        "module": "music.musicasset.MVFavRead",
+        "method": "getMyFavMV_v2",
+        "platform": "desktop",
+        "verify": true,
+        "params": {
+            "encuin": "str encrypt_uin",
+            "num": "int 返回数量",
+            "pagesize": "int 返回页数"
+        },
+        "comment": "通过 encrypt_uin 获取收藏 MV"
+    },
+    "music_gene": {
+        "module": "music.recommend.UserProfileSettingSvr",
+        "method": "GetProfileReport",
+        "params": {
+            "VisitAccount": "str encrypt_uin"
+        },
+        "comment": "获取音乐基因数据"
+    }
+}

qqmusic_api_python-0.1.8/qqmusic_api/data/api-schema.json

@@ -0,0 +1,102 @@
+{
+    "$schema": "https://json-schema.org/draft-07/schema",
+    "type": "object",
+    "properties": {
+        "$schema": {
+            "type": "string",
+            "format": "uri-reference"
+        }
+    },
+    "patternProperties": {
+        ".*": {
+            "type": "object",
+            "properties": {
+                "url": {
+                    "type": "string",
+                    "description": "请求地址"
+                },
+                "method": {
+                    "type": "string",
+                    "description": "请求方法"
+                },
+                "headers": {
+                    "type": "object",
+                    "description": "请求头"
+                },
+                "module": {
+                    "type": "string",
+                    "description": "QQ音乐请求模块，搭配 `method` 使用"
+                },
+                "data": {
+                    "type": "object",
+                    "description": "请求数据"
+                },
+                "params": {
+                    "type": "object",
+                    "description": "请求参数"
+                },
+                "json_body": {
+                    "type": "boolean",
+                    "description": "是否使用 json 作为载荷"
+                },
+                "verify": {
+                    "type": "boolean",
+                    "description": "是否验证账号凭证"
+                },
+                "platform": {
+                    "type": "string",
+                    "description": "API 来源",
+                    "enum": [
+                        "mobile",
+                        "desktop",
+                        "web"
+                    ]
+                },
+                "ignore_code": {
+                    "type": "boolean",
+                    "description": "是否忽略返回值 code 检验直接返回"
+                },
+                "extra_common": {
+                    "type": "object",
+                    "description": "请求QQ音乐的额外公共参数"
+                },
+                "comment": {
+                    "type": "string",
+                    "description": "接口描述"
+                }
+            },
+            "allOf": [
+                {
+                    "if": {
+                        "properties": {
+                            "module": {
+                                "type": "string"
+                            }
+                        },
+                        "required": [
+                            "module"
+                        ]
+                    },
+                    "then": {
+                        "not": {
+                            "required": [
+                                "url",
+                                "data"
+                            ]
+                        },
+                        "required": [
+                            "method",
+                            "params"
+                        ]
+                    },
+                    "else": {
+                        "required": [
+                            "url",
+                            "method"
+                        ]
+                    }
+                }
+            ]
+        }
+    }
+}

{qqmusic_api_python-0.1.7 → qqmusic_api_python-0.1.8}/qqmusic_api/data/file_type.json

@@ -1,13 +1,13 @@
 {
-    "new_0": {
+    "master": {
         "s": "AI00",
         "e": ".flac"
     },
-    "new_1": {
+    "atmos_2": {
         "s": "Q000",
         "e": ".flac"
     },
-    "new_2": {
+    "atmos_51": {
         "s": "Q001",
         "e": ".flac"
     },
@@ -15,6 +15,10 @@
         "s": "F000",
         "e": ".flac"
     },
+    "ogg_640": {
+        "s": "O801",
+        "e": ".ogg"
+    },
     "ogg_320": {
         "s": "O800",
         "e": ".ogg"

qqmusic_api_python-0.1.8/qqmusic_api/exceptions/__init__.py

@@ -0,0 +1,9 @@
+from .api_exception import *
+
+__all__ = [
+    "ApiException",
+    "CredentialInvalidError",
+    "CredentialExpiredError",
+    "LoginError",
+    "ResponseCodeError",
+]

qqmusic_api_python-0.1.8/qqmusic_api/exceptions/api_exception.py

@@ -0,0 +1,60 @@
+"""API Exception"""
+
+
+class ApiException(Exception):
+    """API Exception 基类"""
+
+    def __init__(self, message: str = "出现了错误，但未说明原因") -> None:
+        super().__init__(message)
+        self.message = message
+
+    def __str__(self) -> str:
+        return self.message
+
+
+class ResponseCodeError(ApiException):
+    """API 返回响应的 code 不符合预期"""
+
+    def __init__(
+        self,
+        code: int,
+        data: dict,
+        raw: dict,
+        message: str = "API 返回的响应 code 不符合预期",
+    ) -> None:
+        self.code = code
+        self.data = data
+        self.raw = raw
+        self.message = message
+
+    def __str__(self) -> str:
+        return f"[{self.code}] {self.message}"
+
+
+class CredentialExpiredError(ResponseCodeError):
+    """Credential 过期"""
+
+    def __init__(
+        self,
+        data: dict,
+        raw: dict,
+        message: str = "凭证已过期",
+    ) -> None:
+        super().__init__(1000, data, raw, message)
+
+    def __str__(self) -> str:
+        return self.message
+
+
+class CredentialInvalidError(ApiException):
+    """Credential 无效"""
+
+    def __init__(self, message: str = "凭证无效") -> None:
+        super().__init__(message)
+
+
+class LoginError(ApiException):
+    """登录失败"""
+
+    def __init__(self, message: str = "登录失败") -> None:
+        super().__init__(message)