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

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

@@ -1,9 +1,8 @@
 Metadata-Version: 2.1
 Name: qqmusic-api-python
-Version: 0.1.8
+Version: 0.1.10
 Summary: QQ音乐API封装库
 Keywords: music,api,qqmusic,tencentmusic
-Home-page: https://github.com/luren-dc/QQMusicApi
 Author-Email: Luren <68656403+luren-dc@users.noreply.github.com>
 Maintainer-Email: Luren <68656403+luren-dc@users.noreply.github.com>
 License: MIT
@@ -17,9 +16,9 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: Implementation :: CPython
 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
+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: <3.13,>=3.9
 Requires-Dist: cryptography<42.0.0,>=41.0.2
 Requires-Dist: typing-extensions>=4.12.2
@@ -53,6 +52,8 @@ Description-Content-Type: text/markdown
 
 > [!WARNING]
 > 本仓库的所有内容仅供学习和参考之用，禁止用于商业用途
+>
+> All contents in this repo are for learning and reference only and are not allowed to be used for commercial purposes.
 
 **文档**: <a href="https://luren-dc.github.io/QQMusicApi" target="_blank">https://luren-dc.github.io/QQMusicApi</a>
 

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

@@ -25,6 +25,8 @@
 
 > [!WARNING]
 > 本仓库的所有内容仅供学习和参考之用，禁止用于商业用途
+>
+> All contents in this repo are for learning and reference only and are not allowed to be used for commercial purposes.
 
 **文档**: <a href="https://luren-dc.github.io/QQMusicApi" target="_blank">https://luren-dc.github.io/QQMusicApi</a>
 

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

@@ -39,7 +39,7 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dynamic = []
-version = "0.1.8"
+version = "0.1.10"
 
 [project.license]
 text = "MIT"

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

@@ -1,15 +1,21 @@
-from . import album, login, lyric, mv, search, singer, song, songlist, top, user
+import logging
+
+from . import album, login, login_utils, 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.8"
+__version__ = "0.1.10"
+
+logger = logging.getLogger("qqmusicapi")
+
 
 __all__ = [
     "album",
     "Credential",
     "get_session",
     "login",
+    "login_utils",
     "lyric",
     "mv",
     "search",

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

@@ -1,6 +1,6 @@
 """专辑相关 API"""
 
-from typing import Optional
+from typing import Literal, Optional
 
 from .utils.network import Api
 from .utils.utils import get_api
@@ -8,6 +8,21 @@ from .utils.utils import get_api
 API = get_api("album")
 
 
+def get_album_cover(mid: str, size: Literal[150, 300, 500, 800] = 300) -> str:
+    """获取专辑封面链接
+
+    Args:
+        mid: 专辑 mid
+        size: 封面大小
+
+    Returns:
+        封面链接
+    """
+    if size not in [150, 300, 500, 800]:
+        raise ValueError("not supported size")
+    return f"https://y.gtimg.cn/music/photo_new/T002R{size}x{size}M000{mid}.jpg"
+
+
 class Album:
     """专辑类
 

qqmusic_api_python-0.1.10/qqmusic_api/data/api/login.json

@@ -0,0 +1,196 @@
+{
+    "qq": {
+        "get_qrcode": {
+            "url": "https://ssl.ptlogin2.qq.com/ptqrshow",
+            "params": {
+                "appid": "716027609",
+                "e": "2",
+                "l": "M",
+                "s": "3",
+                "d": "72",
+                "v": "4",
+                "t": "str(random.random())",
+                "daid": "383",
+                "pt_3rd_aid": "100497308"
+            },
+            "headers": {
+                "Referer": "https://xui.ptlogin2.qq.com/"
+            },
+            "comment": "获取二维码二进制数据和 qrsig"
+        },
+        "check_qrcode_state": {
+            "url": "https://ssl.ptlogin2.qq.com/ptqrlogin",
+            "params": {
+                "u1": "https://graph.qq.com/oauth2.0/login_jump",
+                "ptqrtoken": "hash33(qrsig)",
+                "ptredirect": "0",
+                "h": "1",
+                "t": "1",
+                "g": "1",
+                "from_ui": "1",
+                "ptlang": "2052",
+                "action": "0-0-{time.time() * 1000}",
+                "js_ver": "20102616",
+                "js_type": "1",
+                "pt_uistyle": "40",
+                "aid": "716027609",
+                "daid": "383",
+                "pt_3rd_aid": "100497308",
+                "has_onekey": "1"
+            },
+            "headers": {
+                "Referer": "https://xui.ptlogin2.qq.com/"
+            },
+            "comment": "获取二维码状态"
+        },
+        "check_sig": {
+            "url": "https://ssl.ptlogin2.graph.qq.com/check_sig",
+            "ignore_code": true,
+            "params": {
+                "uin": "uin",
+                "pttype": "1",
+                "service": "ptqrlogin",
+                "nodirect": "0",
+                "ptsigx": "sigx",
+                "s_url": "https://graph.qq.com/oauth2.0/login_jump",
+                "ptlang": "2052",
+                "ptredirect": "100",
+                "aid": "716027609",
+                "daid": "383",
+                "j_later": "0",
+                "low_login_hour": "0",
+                "regmaster": "0",
+                "pt_login_type": "3",
+                "pt_aid": "0",
+                "pt_aaid": "16",
+                "pt_light": "0",
+                "pt_3rd_aid": "100497308"
+            },
+            "headers": {
+                "Referer": "https://xui.ptlogin2.qq.com/"
+            },
+            "comment": "获取 p_skey"
+        },
+        "authorize": {
+            "url": "https://graph.qq.com/oauth2.0/authorize",
+            "method": "POST",
+            "ignore_code": true,
+            "data": {
+                "response_type": "code",
+                "client_id": "100497308",
+                "redirect_uri": "https://y.qq.com/portal/wx_redirect.html?login_type=1&surl=https%3A%252F%252Fy.qq.com%252F",
+                "scope": "get_user_info,get_app_friends",
+                "state": "state",
+                "switch": "",
+                "from_ptlogin": "1",
+                "src": "1",
+                "update_auth": "1",
+                "openapi": "1010_1030",
+                "g_tk": "hash33(p_skey, 5381)",
+                "auth_time": "str(int(time.time()) * 1000)",
+                "ui": "str(uuid.uuid4())"
+            },
+            "comment": "QQ 鉴权"
+        },
+        "login": {
+            "module": "QQConnectLogin.LoginServer",
+            "method": "QQLogin",
+            "ignore_code": true,
+            "params": {
+                "code": "str 鉴权码",
+                "musicid": "int",
+                "musickey": "str",
+                "refresh_key": "str",
+                "refresh_token": "str"
+            },
+            "extra_common": {
+                "tmeLoginType": "str 2"
+            },
+            "comment": "QQ 登录"
+        }
+    },
+    "wx": {
+        "get_qrcode": {
+            "url": "https://open.weixin.qq.com/connect/qrconnect",
+            "params": {
+                "appid": "wx48db31d50e334801",
+                "redirect_uri": "https://y.qq.com/portal/wx_redirect.html?login_type=2&surl=https://y.qq.com/",
+                "response_type": "code",
+                "scope": "snsapi_login",
+                "state": "STATE",
+                "href": "https://y.qq.com/mediastyle/music_v17/src/css/popup_wechat.css#wechat_redirect"
+            },
+            "comment": "获取二维码二进制数据和 uuid"
+        },
+        "check_qrcode_state": {
+            "url": "https://lp.open.weixin.qq.com/connect/l/qrconnect",
+            "params": {
+                "uuid": "str uuid",
+                "_": "str 毫秒级时间戳"
+            },
+            "headers": {
+                "Referer": "https://open.weixin.qq.com/"
+            },
+            "comment": "获取二维码状态"
+        },
+        "login": {
+            "module": "music.login.LoginServer",
+            "method": "Login",
+            "ignore_code": true,
+            "params": {
+                "strAppid": "wx48db31d50e334801",
+                "code": "str 鉴权码",
+                "musicid": "int",
+                "musickey": "str",
+                "refresh_key": "str",
+                "refresh_token": "str",
+                "loginMode": "int 2"
+            },
+            "extra_common": {
+                "tmeLoginType": "str 1"
+            },
+            "comment": "微信登录"
+        }
+    },
+    "phone": {
+        "send_authcode": {
+            "module": "music.login.LoginServer",
+            "method": "SendPhoneAuthCode",
+            "ignore_code": true,
+            "params": {
+                "tmeAppid": "qqmusic",
+                "phoneNo": "str 手机号",
+                "encryptedPhoneNo ": "str 加密手机号",
+                "areaCode": "str 国家码(86)"
+            },
+            "extra_common": {
+                "tmeLoginMethod": "str 3"
+            },
+            "comment": "发送验证码"
+        },
+        "login": {
+            "module": "music.login.LoginServer",
+            "method": "Login",
+            "ignore_code": true,
+            "params": {
+                "code": "str 验证码",
+                "phoneNo": "str 手机号",
+                "encryptedPhoneNo ": "str 加密手机号",
+                "areaCode": "str 国家码(86)",
+                "loginMode": "int 1"
+            },
+            "extra_common": {
+                "tmeLoginMethod": "str 3",
+                "tmeLoginType": "str 0"
+            },
+            "comment": "手机验证码鉴权"
+        }
+    },
+    "check_expired": {
+        "module": "music.UserInfo.userInfoServer",
+        "method": "GetLoginUserInfo",
+        "verify": true,
+        "params": {},
+        "comment": "获取登录用户的信息，用于检测凭证是否失效"
+    }
+}