p123client 0.0.6.9.4__py3-none-any.whl → 0.0.6.10__py3-none-any.whl

p123client/client.py

@@ -5,13 +5,14 @@ from __future__ import annotations
 
 __all__ = ["check_response", "P123OpenClient", "P123Client"]
 
-from base64 import b64decode
+import errno
+
+from base64 import urlsafe_b64decode
 from collections.abc import (
     AsyncIterable, Awaitable, Buffer, Callable, Coroutine, 
     ItemsView, Iterable, Iterator, Mapping, MutableMapping, 
 )
 from contextlib import contextmanager
-from errno import EAUTH, EIO, EISDIR, ENOENT
 from functools import partial
 from hashlib import md5
 from http.cookiejar import CookieJar
@@ -21,9 +22,11 @@ from os import fsdecode, fstat, isatty, PathLike
 from os.path import basename
 from pathlib import Path, PurePath
 from re import compile as re_compile, MULTILINE
+from string import digits, ascii_uppercase
 from sys import _getframe
 from tempfile import TemporaryFile
 from typing import cast, overload, Any, Final, Literal, Self
+from urllib.parse import parse_qsl, urlsplit
 from uuid import uuid4
 from warnings import warn
 
@@ -39,11 +42,14 @@ from http_request import (
     encode_multipart_data, encode_multipart_data_async, SupportsGeturl, 
 )
 from iterutils import run_gen_step
+from orjson import loads
 from property import locked_cacheproperty
 from yarl import URL
 
 from .const import CLIENT_API_METHODS_MAP, CLIENT_METHOD_API_MAP
-from .exception import P123OSError, P123BrokenUpload, P123LoginError, P123AuthenticationError
+from .exception import (
+    P123OSError, P123BrokenUpload, P123LoginError, P123AuthenticationError, P123FileNotFoundError, 
+)
 
 
 # 默认使用的域名
@@ -66,7 +72,6 @@ def get_default_request():
 
 
 def default_parse(_, content: Buffer, /):
-    from orjson import loads
     if isinstance(content, (bytes, bytearray, memoryview)):
         return loads(content)
     else:
@@ -179,15 +184,23 @@ def check_response(resp: dict | Awaitable[dict], /) -> dict | Coroutine[Any, Any
     """
     def check(resp, /) -> dict:
         if not isinstance(resp, dict):
-            raise P123OSError(EIO, resp)
+            raise P123OSError(errno.EIO, resp)
         code = resp.get("code", 0)
         if code in (0, 200):
             return resp
         match code:
-            case 401:
-                raise P123AuthenticationError(EAUTH, resp)
+            case 1: # 内部错误
+                raise P123AuthenticationError(errno.EIO, resp)
+            case 401: # access_token 失效
+                raise P123AuthenticationError(errno.EAUTH, resp)
+            case 429: # 请求太频繁
+                raise P123OSError(errno.EBUSY, resp)
+            case 5066: # 文件不存在
+                raise P123FileNotFoundError(errno.ENOENT, resp)
+            case 5113: # 流量超限
+                raise P123OSError(errno.EIO, resp)
             case _:
-                raise P123OSError(EIO, resp)
+                raise P123OSError(errno.EIO, resp)
     if isawaitable(resp):
         async def check_await() -> dict:
             return check(await resp)
@@ -204,6 +217,9 @@ class P123OpenClient:
         https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced
     """
 
+    client_id: str = ""
+    client_secret: str = ""
+    refresh_token: str = ""
     token_path: None | PurePath = None
 
     def __init__(
@@ -211,14 +227,16 @@ class P123OpenClient:
         client_id: str | PathLike = "", 
         client_secret: str = "", 
         token: None | str | PathLike = None, 
+        refresh_token: str = "", 
     ):
         if isinstance(client_id, PathLike):
             token = client_id
         else:
             self.client_id = client_id
-            self.client_secret = client_secret
+        self.client_secret = client_secret
+        self.refresh_token = refresh_token
         if token is None:
-            if client_id and client_secret:
+            if client_id and client_secret or refresh_token:
                 self.login_open()
         elif isinstance(token, str):
             self.token = token.removeprefix("Bearer ")
@@ -228,7 +246,7 @@ class P123OpenClient:
             else:
                 self.token_path = Path(fsdecode(token))
             self._read_token()
-            if not self.token and client_id and client_secret:
+            if not self.token and (client_id and client_secret or refresh_token):
                 self.login_open()
 
     def __del__(self, /):
@@ -322,8 +340,7 @@ class P123OpenClient:
 
     @locked_cacheproperty
     def token_user_info(self, /) -> dict:
-        from orjson import loads
-        return loads(b64decode(self.token.split(".", 2)[1] + "=="))
+        return loads(urlsafe_b64decode(self.token.split(".", 2)[1] + "=="))
 
     @locked_cacheproperty
     def user_id(self, /) -> dict:
@@ -403,7 +420,8 @@ class P123OpenClient:
         /, 
         client_id: str = "", 
         client_secret: str = "", 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
+        refresh_token: str = "", 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
@@ -415,7 +433,8 @@ class P123OpenClient:
         /, 
         client_id: str = "", 
         client_secret: str = "", 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
+        refresh_token: str = "", 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -426,7 +445,8 @@ class P123OpenClient:
         /, 
         client_id: str = "", 
         client_secret: str = "", 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
+        refresh_token: str = "", 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
@@ -435,6 +455,7 @@ class P123OpenClient:
 
         :param client_id: 应用标识，创建应用时分配的 appId
         :param client_secret: 应用密钥，创建应用时分配的 secretId
+        :param refresh_token: 刷新令牌
         :param base_url: 接口的基地址
         :param async_: 是否异步
         :param request_kwargs: 其它请求参数
@@ -445,222 +466,323 @@ class P123OpenClient:
             self.client_id = client_id
         else:
             client_id = self.client_id
+        if client_secret:
+            self.client_secret = client_secret
+        else:
+            client_secret = self.client_secret
+        if refresh_token:
+            self.refresh_token = refresh_token
+        else:
+            refresh_token = self.refresh_token
+        def gen_step():
+            if refresh_token:
+                resp = yield self.login_with_refresh_token(
+                    refresh_token, 
+                    base_url=base_url, 
+                    async_=async_, 
+                    **request_kwargs, 
+                )
+                self.token = resp["access_token"]
+                self.refresh_token = resp["refresh_token"]
+                return resp
+            else:
+                resp = yield self.login_token_open( # type: ignore
+                    {"clientID": client_id, "clientSecret": client_secret}, 
+                    base_url=base_url, 
+                    async_=async_, 
+                    **request_kwargs, 
+                )
+                check_response(resp)
+                self.token = resp["data"]["accessToken"]
+                return resp
+        return run_gen_step(gen_step, async_)
+
+    @overload
+    def login_another_oauth(
+        self, 
+        /, 
+        redirect_uri: str, 
+        client_id: str = "", 
+        client_secret: str = "", 
+        replace: bool | Self = False, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> Self:
+        ...
+    @overload
+    def login_another_oauth(
+        self, 
+        /, 
+        redirect_uri: str, 
+        client_id: str = "", 
+        client_secret: str = "", 
+        replace: bool | Self = False, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, Self]:
+        ...
+    def login_another_oauth(
+        self, 
+        /, 
+        redirect_uri: str, 
+        client_id: str = "", 
+        client_secret: str = "", 
+        replace: bool | Self = False, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> Self | Coroutine[Any, Any, Self]:
+        """第三方应用授权登录
+
+        :param redirect_uri: 回调链接
+        :param client_id: 应用标识，创建应用时分配的 appId
+        :param client_secret: 应用密钥，创建应用时分配的 secretId
+        :param replace: 替换某个 client 对象的 token
+
+            - 如果为 P123Client, 则更新到此对象
+            - 如果为 True，则更新到 `self``
+            - 如果为 False，否则返回新的 ``P123Client`` 对象
+
+        :param async_: 是否异步
+        :param request_kwargs: 其它请求参数
+
+        :return: 接口响应
+        """
         if client_id:
+            self.client_id = client_id
+        else:
+            client_id = self.client_id
+        if client_secret:
             self.client_secret = client_secret
         else:
             client_secret = self.client_secret
         def gen_step():
-            resp = yield self.login_access_token_open( # type: ignore
-                {"clientID": client_id, "clientSecret": client_secret}, 
+            resp = yield self.login_with_oauth(
+                client_id, 
+                client_secret, 
+                redirect_uri=redirect_uri, 
+                token=self.token, 
                 base_url=base_url, 
                 async_=async_, 
                 **request_kwargs, 
             )
-            check_response(resp)
-            self.token = resp["data"]["accessToken"]
-            return resp
+            token = resp["access_token"]
+            refresh_token = resp["refresh_token"]
+            if replace is False:
+                return type(self)(
+                    client_id=client_id, 
+                    client_secret=client_secret, 
+                    token=token, 
+                    refresh_token=refresh_token, 
+                )
+            elif replace is True:
+                inst = self
+            else:
+                inst = replace
+            inst.token = token
+            inst.refresh_token = refresh_token
+            return inst
         return run_gen_step(gen_step, async_)
 
     @overload
-    @staticmethod
-    def login_access_token(
-        payload: dict, 
+    def login_another_refresh_token(
+        self, 
         /, 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
-        request: None | Callable = None, 
+        refresh_token: str = "", 
+        replace: bool | Self = False, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
-    ) -> dict:
+    ) -> Self:
         ...
     @overload
-    @staticmethod
-    def login_access_token(
-        payload: dict, 
+    def login_another_refresh_token(
+        self, 
         /, 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
-        request: None | Callable = None, 
+        refresh_token: str = "", 
+        replace: bool | Self = False, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
-    ) -> Coroutine[Any, Any, dict]:
+    ) -> Coroutine[Any, Any, Self]:
         ...
-    @staticmethod
-    def login_access_token(
-        payload: dict, 
+    def login_another_refresh_token(
+        self, 
         /, 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
-        request: None | Callable = None, 
+        refresh_token: str = "", 
+        replace: bool | Self = False, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
-    ) -> dict | Coroutine[Any, Any, dict]:
-        """获取access_token
-
-        POST https://open-api.123pan.com/api/v1/access_token
-
-        .. attention::
-            此接口有访问频率限制。请获取到 `access_token` 后本地保存使用，并在 `access_token `过期前及时重新获取。`access_token` 有效期根据返回的 "expiredAt" 字段判断。
-
-        .. note::
-            通过这种方式授权得到的 `access_token`，各个接口分别允许一个较低的 QPS
-
-            /接入指南/开发者接入/开发须知
+    ) -> Self | Coroutine[Any, Any, Self]:
+        """登录以获取 access_token
 
-            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/txgcvbfgh0gtuad5
+        :param refresh_token: 刷新令牌
+        :param replace: 替换某个 client 对象的 token
 
-        .. admonition:: Reference
-            /接入指南/开发者接入/获取access_token
+            - 如果为 P123Client, 则更新到此对象
+            - 如果为 True，则更新到 `self``
+            - 如果为 False，否则返回新的 ``P123Client`` 对象
 
-            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/gn1nai4x0v0ry9ki
+        :param base_url: 接口的基地址
+        :param async_: 是否异步
+        :param request_kwargs: 其它请求参数
 
-        :payload:
-            - clientID: str     💡 应用标识，创建应用时分配的 appId
-            - clientSecret: str 💡 应用密钥，创建应用时分配的 secretId
+        :return: 接口的响应信息
         """
-        request_kwargs.setdefault("parse", default_parse)
-        if request is None:
-            request = get_default_request()
-            request_kwargs["async_"] = async_
-        return request(
-            url=complete_url("/api/v1/access_token", base_url), 
-            method="POST", 
-            json=payload, 
-            **request_kwargs, 
-        )
+        if refresh_token:
+            self.refresh_token = refresh_token
+        else:
+            refresh_token = self.refresh_token
+        def gen_step():
+            nonlocal refresh_token
+            resp = yield self.login_with_refresh_token(
+                refresh_token, 
+                base_url=base_url, 
+                async_=async_, 
+                **request_kwargs, 
+            )
+            token = resp["access_token"]
+            refresh_token = resp["refresh_token"]
+            if replace is False:
+                return type(self)(
+                    token=token, 
+                    refresh_token=refresh_token, 
+                )
+            elif replace is True:
+                inst = self
+            else:
+                inst = replace
+            inst.token = token
+            inst.refresh_token = refresh_token
+            return inst
+        return run_gen_step(gen_step, async_)
 
     @overload
-    @staticmethod
-    def login_auth(
-        payload: dict, 
+    def login_with_oauth(
+        cls, 
         /, 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
-        request: None | Callable = None, 
+        client_id: str, 
+        client_secret: str, 
+        redirect_uri: str, 
+        token: str, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    @staticmethod
-    def login_auth(
-        payload: dict, 
+    def login_with_oauth(
+        cls, 
         /, 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
-        request: None | Callable = None, 
+        client_id: str, 
+        client_secret: str, 
+        redirect_uri: str, 
+        token: str, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    @staticmethod
-    def login_auth(
-        payload: dict, 
+    def login_with_oauth(
+        cls, 
         /, 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
-        request: None | Callable = None, 
+        client_id: str, 
+        client_secret: str, 
+        redirect_uri: str, 
+        token: str, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """授权地址
-
-        GET https://www.123pan.com/auth
+        """第三方应用授权登录
 
-        .. admonition:: Reference
-            /接入指南/第三方挂载应用接入/授权地址
-
-            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/gr7ggimkcysm18ap
+        :param client_id: 应用标识，创建应用时分配的 appId
+        :param client_secret: 应用密钥，创建应用时分配的 secretId
+        :param redirect_uri: 回调链接
+        :param token: 访问令牌
+        :param async_: 是否异步
+        :param request_kwargs: 其它请求参数
 
-        :payload:
-            - client_id: str    💡 应用标识，创建应用时分配的 appId
-            - redirect_uri: str 💡 应用注册的回调地址
-            - scope: str = "user:base,file:all:read,file:all:write" 💡 权限
-            - state: str = ""   💡 自定义参数，任意取值
+        :return: 接口响应
         """
-        request_kwargs.setdefault("parse", default_parse)
-        payload = dict_to_lower_merge(payload, scope="user:base,file:all:read,file:all:write")
-        if request is None:
-            request = get_default_request()
-            request_kwargs["async_"] = async_
-        return request(
-            url=complete_url("/auth", base_url), 
-            params=payload, 
-            **request_kwargs, 
-        )
+        def gen_step():
+            resp = yield cls.login_oauth_authorize(
+                {"accessToken": token, "client_id": client_id, "redirect_uri": redirect_uri}, 
+                base_url=base_url, 
+                async_=async_, 
+                **request_kwargs, 
+            )
+            check_response(resp)
+            authorization_code = resp["data"]["code"]
+            return cls.login_oauth_token(
+                {
+                    "client_id": client_id, 
+                    "client_secret": client_secret, 
+                    "code": authorization_code, 
+                    "grant_type": "authorization_code", 
+                    "redirect_uri": redirect_uri, 
+                }, 
+                base_url=base_url, 
+                async_=async_, 
+                **request_kwargs, 
+            )
+        return run_gen_step(gen_step, async_)
 
     @overload
-    @staticmethod
-    def login_refresh_token(
-        payload: dict, 
+    def login_with_refresh_token(
+        cls, 
         /, 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
-        request: None | Callable = None, 
+        refresh_token: str, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    @staticmethod
-    def login_refresh_token(
-        payload: dict, 
+    def login_with_refresh_token(
+        cls, 
         /, 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
-        request: None | Callable = None, 
+        refresh_token: str, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    @staticmethod
-    def login_refresh_token(
-        payload: dict, 
+    def login_with_refresh_token(
+        cls, 
         /, 
-        base_url: str | Callable[[], str] = "https://www.123pan.com", 
-        request: None | Callable = None, 
+        refresh_token: str, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """授权code获取access_token
-
-        POST https://open-api.123pan.com/api/v1/oauth2/access_token
-
-        .. note::
-            通过这种方式授权得到的 `access_token`，各个接口分别允许更高的 QPS
-
-            /接入指南/第三方挂载应用接入/授权须知
-
-            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/kf05anzt1r0qnudd
+        """通过刷新令牌登录
 
-        .. admonition:: Reference
-            /接入指南/第三方挂载应用接入/授权code获取access_token
-
-            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/gammzlhe6k4qtwd9
+        :param refresh_token: 刷新令牌
+        :param async_: 是否异步
+        :param request_kwargs: 其它请求参数
 
-        :payload:
-            - client_id: str        💡 应用标识，创建应用时分配的 appId
-            - client_secret: str    💡 应用密钥，创建应用时分配的 secretId
-            - code: str = <default> 💡 授权码
-            - grant_type: "authorization_code" | "refresh_token" = <default> 💡 身份类型
-            - redirect_uri: str = <default>  💡 应用注册的回调地址，`grant_type` 为 "authorization_code" 时必携带
-            - refresh_token: str = <default> 💡 刷新 token，单次请求有效
+        :return: 接口响应
         """
-        request_kwargs.setdefault("parse", default_parse)
-        payload = dict_to_lower(payload)
-        if not payload.get("grant_type"):
-            if payload.get("refresh_token"):
-                payload["grant_type"] = "refresh_token"
-            else:
-                payload["grant_type"] = "authorization_code"
-        if request is None:
-            request = get_default_request()
-            request_kwargs["async_"] = async_
-        return request(
-            url=complete_url("/api/v1/oauth2/access_token", base_url), 
-            method="POST", 
-            params=payload, 
+        return cls.login_oauth_token(
+            {"grant_type": "refresh_token", "refresh_token": refresh_token}, 
+            base_url=base_url, 
+            async_=async_, 
             **request_kwargs, 
         )
 
@@ -699,6 +821,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/developer/config/forbide-ip/list
 
         .. admonition:: Reference
+
             /API列表/直链/IP黑名单配置/ip黑名单列表
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/mxldrm9d5gpw5h2d
@@ -745,6 +868,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/developer/config/forbide-ip/switch
 
         .. admonition:: Reference
+
             /API列表/直链/IP黑名单配置/开启关闭ip黑名单
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/xwx77dbzrkxquuxm
@@ -796,6 +920,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/developer/config/forbide-ip/update
 
         .. admonition:: Reference
+
             /API列表/直链/IP黑名单配置/更新ip黑名单列表
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/tt3s54slh87q8wuh
@@ -851,6 +976,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/direct-link/disable
 
         .. admonition:: Reference
+
             /API列表/直链/禁用直链空间
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/ccgz6fwf25nd9psl
@@ -899,6 +1025,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/direct-link/enable
 
         .. admonition:: Reference
+
             /API列表/直链/启用直链空间
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/cl3gvdmho288d376
@@ -947,6 +1074,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/direct-link/log
 
         .. admonition:: Reference
+
             /API列表/直链/获取直链日志
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/agmqpmu0dm0iogc9
@@ -1011,18 +1139,18 @@ class P123OpenClient:
         :return:
             响应数据的 data 字段是一个字典，键值如下：
 
-            +---------------------+--------+----------+--------------------------------------------------------------+
-            | 名称                | 类型   | 是否必填 | 说明                                                         |
-            +=====================+========+==========+==============================================================+
-            | list                | array  | 必填     | 响应列表                                                     |
-            +---------------------+--------+----------+--------------------------------------------------------------|
-            | list[*].resolutions | string | 必填     | 分辨率                                                       |
-            +---------------------+--------+----------+--------------------------------------------------------------|
-            | list[*].address     | string | 必填     | 播放地址。请将播放地址放入支持的 hls 协议的播放器中进行播放。|
-            |                     |        |          | 示例在线播放地址: https://m3u8-player.com/                   |
-            |                     |        |          | 请注意：转码链接播放过程中将会消耗您的直链流量。             |
-            |                     |        |          | 如果您开启了直链鉴权,也需要将转码链接根据鉴权指引进行签名。  |
-            +---------------------+--------+----------+--------------------------------------------------------------+
+            +-------------------------+--------+----------+----------------------------------------------------------------+
+            | 名称                    | 类型   | 是否必填 | 说明                                                           |
+            +=========================+========+==========+================================================================+
+            | ``list``                | array  | 必填     | 响应列表                                                       |
+            +-------------------------+--------+----------+----------------------------------------------------------------+
+            | ``list[*].resolutions`` | string | 必填     | 分辨率                                                         |
+            +-------------------------+--------+----------+----------------------------------------------------------------+
+            | ``list[*].address``     | string | 必填     | | 播放地址。请将播放地址放入支持的 hls 协议的播放器中进行播放。|
+            |                         |        |          | | 示例在线播放地址: https://m3u8-player.com/                   |
+            |                         |        |          | | 请注意：转码链接播放过程中将会消耗您的直链流量。             |
+            |                         |        |          | | 如果您开启了直链鉴权,也需要将转码链接根据鉴权指引进行签名。  |
+            +-------------------------+--------+----------+----------------------------------------------------------------+
         """
         api = complete_url("/api/v1/direct-link/get/m3u8", base_url)
         if not isinstance(payload, dict):
@@ -1065,6 +1193,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/direct-link/offline/logs
 
         .. admonition:: Reference
+
             /API列表/直链/获取直链离线日志
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/yz4bdynw9yx5erqb
@@ -1229,6 +1358,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/direct-link/url
 
         .. admonition:: Reference
+
             /API列表/直链/获取直链链接
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/tdxfsmtemp4gu4o2
@@ -1279,6 +1409,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/file/download_info
 
         .. admonition:: Reference
+
             /API列表/文件管理/下载
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/fnf60phsushn8ip2
@@ -1333,6 +1464,7 @@ class P123OpenClient:
             彻底删除文件前，文件必须要在回收站中，否则无法删除        
 
         .. admonition:: Reference
+
             /API列表/文件管理/删除/彻底删除文件
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/sg2gvfk5i3dwoxtg
@@ -1385,6 +1517,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/file/detail
 
         .. admonition:: Reference
+
             /API列表/文件管理/文件详情/获取单个文件详情
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/owapsz373dzwiqbp
@@ -1436,6 +1569,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/file/infos
 
         .. admonition:: Reference
+
             /API列表/文件管理/文件详情/获取多个文件详情
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/cqqayfuxybegrlru
@@ -1488,6 +1622,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v2/file/list
 
         .. admonition:: Reference
+
             /API列表/文件管理/文件列表/获取文件列表（推荐）
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/zrip9b0ye81zimv4
@@ -1505,7 +1640,7 @@ class P123OpenClient:
             其它则代表下一页开始的文件 id，携带到请求参数中，可查询下一页。
 
         .. caution::
-            此接口查询结果包含回收站的文件，需自行根据字段 `trashed` 判断处理
+            此接口查询结果包含回收站的文件，需自行根据字段 ``trashed`` 判断处理
 
         :payload:
             - businessType: int = <default> 💡 业务类型：2:转码空间
@@ -1513,7 +1648,7 @@ class P123OpenClient:
             - lastFileId: int = <default>   💡 上一页的最后一条记录的 FileID，翻页查询时需要填写
             - limit: int = 100              💡 分页大小，最多 100
             - parentFileId: int | str = 0   💡 父目录 id，根目录是 0
-            - searchData: str = <default>   💡 搜索关键字，将无视 `parentFileId`，而进行全局查找
+            - searchData: str = <default>   💡 搜索关键字，将无视 ``parentFileId``，而进行全局查找
             - searchMode: 0 | 1 = 0         💡 搜索模式
 
                 - 0: 模糊搜索（将会根据搜索项分词，查找出相似的匹配项）
@@ -1570,12 +1705,13 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/file/list
 
         .. admonition:: Reference
+
             /API列表/文件管理/文件列表/获取文件列表（旧）
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/hosdqqax0knovnm2
 
         .. note::
-            是否有下一页需要自行判断。如果返回的列表大小 < `limit`，或者根据返回值里的 "total"，如果 = `page * limit`，都说明没有下一页
+            是否有下一页需要自行判断。如果返回的列表大小 < ``limit``，或者根据返回值里的 "total"，如果 = ``page * limit``，都说明没有下一页
 
         :payload:
             - limit: int = 100         💡 分页大小，最多 100
@@ -1597,7 +1733,7 @@ class P123OpenClient:
             - page: int = 1               💡 第几页，从 1 开始（可传 0 或不传，视为 1）
             - parentFileId: int | str = 0 💡 父目录 id，根目录是 0
             - trashed: "false" | "true" = "false" 💡 是否查看回收站的文件
-            - searchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
+            - searchData: str = <default> 💡 搜索关键字（将无视 ``parentFileId`` 参数）
         """
         api = complete_url("/api/v1/file/list", base_url)
         if isinstance(payload, (int, str)):
@@ -1651,6 +1787,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/upload/v1/file/mkdir
 
         .. admonition:: Reference
+
             /API列表/文件管理/上传/创建目录
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/ouyvcxqg3185zzk4
@@ -1704,6 +1841,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/file/move
 
         .. admonition:: Reference
+
             /API列表/文件管理/移动
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/rsyfsn1gnpgo4m4f
@@ -1758,6 +1896,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/file/recover
 
         .. admonition:: Reference
+
             /API列表/文件管理/删除/从回收站恢复文件
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/kx9f8b6wk6g55uwy
@@ -1775,164 +1914,470 @@ class P123OpenClient:
         return self.request(api, "POST", json=payload, async_=async_, **request_kwargs)
 
     @overload
-    def fs_rename(
-        self, 
-        payload: dict | str | tuple[int | str, str] | Iterable[str | tuple[int | str, str]], 
+    def fs_rename(
+        self, 
+        payload: dict | str | tuple[int | str, str] | Iterable[str | tuple[int | str, str]], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_rename(
+        self, 
+        payload: dict | str | tuple[int | str, str] | Iterable[str | tuple[int | str, str]], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_rename(
+        self, 
+        payload: dict | str | tuple[int | str, str] | Iterable[str | tuple[int | str, str]], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """批量文件重命名
+
+        POST https://open-api.123pan.com/api/v1/file/rename
+
+        .. admonition:: Reference
+
+            /API列表/文件管理/重命名/批量文件重命名
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/imhguepnr727aquk
+
+        :payload:
+            - renameList: list[str] 💡 列表，每个成员的格式为 f"{fileId}|{fileName}"，最多 30 个
+        """
+        api = complete_url("/api/v1/file/rename", base_url)
+        if not isinstance(payload, dict):
+            if isinstance(payload, str):
+                payload = [payload]
+            elif isinstance(payload, tuple):
+                payload = ["%s|%s" % payload]
+            else:
+                payload = [s if isinstance(s, str) else "%s|%s" % s for s in payload]
+            payload = {"renameList": payload}
+        return self.request(api, "POST", json=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_rename_one(
+        self, 
+        payload: dict | str | tuple[int | str, str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_rename_one(
+        self, 
+        payload: dict | str | tuple[int | str, str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_rename_one(
+        self, 
+        payload: dict | str | tuple[int | str, str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """单个文件重命名
+
+        PUT https://open-api.123pan.com/api/v1/file/name
+
+        .. admonition:: Reference
+
+            /API列表/文件管理/重命名/单个文件重命名
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/ha6mfe9tteht5skc
+
+        :payload:
+            - fileId: int   💡 文件 id
+            - fileName: str 💡 文件名
+        """
+        api = complete_url("/api/v1/file/name", base_url)
+        if not isinstance(payload, dict):
+            fid: int | str
+            if isinstance(payload, str):
+                fid, name = payload.split("|", 1)
+            else:
+                fid, name = payload
+            payload = {"fileId": fid, "fileName": name}
+        return self.request(api, "PUT", json=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_trash(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_trash(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_trash(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """删除文件至回收站
+
+        POST https://open-api.123pan.com/api/v1/file/trash
+
+        .. admonition:: Reference
+
+            /API列表/文件管理/删除/删除文件至回收站
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/en07662k2kki4bo6
+
+        :payload:
+            - fileIDs: list[int] 💡 文件 id 列表，最多 100 个
+        """
+        api = complete_url("/api/v1/file/trash", base_url)
+        if not isinstance(payload, dict):
+            if isinstance(payload, (int, str)):
+                payload = [payload]
+            elif not isinstance(payload, (tuple, list)):
+                payload = list(payload)
+            payload = {"fileIDs": payload}
+        return self.request(api, "POST", json=payload, async_=async_, **request_kwargs)
+
+    ########## Login API ##########
+
+    @overload
+    @staticmethod
+    def login_token(
+        payload: dict, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    @staticmethod
+    def login_token(
+        payload: dict, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    @staticmethod
+    def login_token(
+        payload: dict, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取access_token
+
+        POST https://open-api.123pan.com/api/v1/access_token
+
+        .. attention::
+            此接口有访问频率限制。请获取到 ``access_token`` 后本地保存使用，并在 `access_token `过期前及时重新获取。``access_token`` 有效期根据返回的 "expiredAt" 字段判断。
+
+        .. note::
+            通过这种方式授权得到的 ``access_token``，各个接口分别允许一个较低的 QPS
+
+            /接入指南/开发者接入/开发须知
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/txgcvbfgh0gtuad5
+
+        .. admonition:: Reference
+
+            /接入指南/开发者接入/获取access_token
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/gn1nai4x0v0ry9ki
+
+        :payload:
+            - clientID: str     💡 应用标识，创建应用时分配的 appId
+            - clientSecret: str 💡 应用密钥，创建应用时分配的 secretId
+        """
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            if headers := request_kwargs.get("headers"):
+                headers = dict(headers, platform="open_platform")
+            else:
+                headers = {"platform": "open_platform"}
+            request_kwargs["headers"] = headers
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("/api/v1/access_token", base_url), 
+            method="POST", 
+            json=payload, 
+            **request_kwargs, 
+        )
+
+    @overload
+    @staticmethod
+    def login_oauth_authorize(
+        payload: dict, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    def fs_rename(
-        self, 
-        payload: dict | str | tuple[int | str, str] | Iterable[str | tuple[int | str, str]], 
+    @staticmethod
+    def login_oauth_authorize(
+        payload: dict, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_rename(
-        self, 
-        payload: dict | str | tuple[int | str, str] | Iterable[str | tuple[int | str, str]], 
+    @staticmethod
+    def login_oauth_authorize(
+        payload: dict, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """批量文件重命名
+        """授权以获取和 ``accessToken`` 绑定的 ``code``
 
-        POST https://open-api.123pan.com/api/v1/file/rename
+        GET https://open-api.123pan.com/api/v1/oauth2/user/authorize
 
         .. admonition:: Reference
-            /API列表/文件管理/重命名/批量文件重命名
 
-            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/imhguepnr727aquk
+            /接入指南/第三方挂载应用接入/授权地址
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/gr7ggimkcysm18ap
 
         :payload:
-            - renameList: list[str] 💡 列表，每个成员的格式为 f"{fileId}|{fileName}"，最多 30 个
-        """
-        api = complete_url("/api/v1/file/rename", base_url)
-        if not isinstance(payload, dict):
-            if isinstance(payload, str):
-                payload = [payload]
-            elif isinstance(payload, tuple):
-                payload = ["%s|%s" % payload]
+            - accessToken: str  💡 访问令牌
+            - client_id: str    💡 应用标识，创建应用时分配的 appId
+            - redirect_uri: str 💡 回调链接
+            - scope: str = "user:base,file:all:read,file:all:write" 💡 权限
+            - response_type: str = "code"
+            - state: str = <default>
+        """
+        def parse(resp, _, /):
+            url = resp.headers["location"]
+            data = dict(parse_qsl(urlsplit(url).query))
+            if "code" in data:
+                code = 0
+                message = "ok"
             else:
-                payload = [s if isinstance(s, str) else "%s|%s" % s for s in payload]
-            payload = {"renameList": payload}
-        return self.request(api, "POST", json=payload, async_=async_, **request_kwargs)
+                code = 1
+                message = data.get("error_description") or "error"
+            return {
+                "code": code, 
+                "message": message, 
+                "url": url, 
+                "data": data, 
+                "headers": dict(resp.headers), 
+            }
+        request_kwargs.setdefault("parse", parse)
+        for key in ("allow_redirects", "follow_redirects", "redirect"):
+            request_kwargs[key] = False
+        payload = dict_to_lower_merge(
+            payload, 
+            response_type="code", 
+            scope="user:base,file:all:read,file:all:write", 
+        )
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("/api/v1/oauth2/user/authorize", base_url), 
+            params=payload, 
+            **request_kwargs, 
+        )
 
     @overload
-    def fs_rename_one(
-        self, 
-        payload: dict | str | tuple[int | str, str], 
+    @staticmethod
+    def login_oauth_token(
+        payload: dict, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    def fs_rename_one(
-        self, 
-        payload: dict | str | tuple[int | str, str], 
+    @staticmethod
+    def login_oauth_token(
+        payload: dict, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_rename_one(
-        self, 
-        payload: dict | str | tuple[int | str, str], 
+    @staticmethod
+    def login_oauth_token(
+        payload: dict, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """单个文件重命名
+        """通过 ``authorization_code`` 或 ``refresh_token`` 获取新的 ``access_token`` 和 ``refresh_token``
 
-        PUT https://open-api.123pan.com/api/v1/file/name
+        POST https://open-api.123pan.com/api/v1/oauth2/access_token
+
+        .. note::
+            通过这种方式授权得到的 ``access_token``，各个接口分别允许更高的 QPS
+
+            /接入指南/第三方挂载应用接入/授权须知
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/kf05anzt1r0qnudd
 
         .. admonition:: Reference
-            /API列表/文件管理/重命名/单个文件重命名
 
-            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/ha6mfe9tteht5skc
+            /接入指南/第三方挂载应用接入/授权code获取access_token
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/gammzlhe6k4qtwd9
 
         :payload:
-            - fileId: int   💡 文件 id
-            - fileName: str 💡 文件名
+            - client_id: str        💡 应用标识，创建应用时分配的 appId
+            - client_secret: str    💡 应用密钥，创建应用时分配的 secretId
+            - code: str = <default> 💡 授权码
+            - grant_type: "authorization_code" | "refresh_token" = <default> 💡 身份类型
+            - redirect_uri: str = <default>  💡 应用注册的回调地址，``grant_type`` 为 "authorization_code" 时必携带
+            - refresh_token: str = <default> 💡 刷新 token，单次请求有效
         """
-        api = complete_url("/api/v1/file/name", base_url)
-        if not isinstance(payload, dict):
-            fid: int | str
-            if isinstance(payload, str):
-                fid, name = payload.split("|", 1)
+        request_kwargs.setdefault("parse", default_parse)
+        payload = dict_to_lower(payload)
+        if not payload.get("grant_type"):
+            if payload.get("refresh_token"):
+                payload["grant_type"] = "refresh_token"
             else:
-                fid, name = payload
-            payload = {"fileId": fid, "fileName": name}
-        return self.request(api, "PUT", json=payload, async_=async_, **request_kwargs)
+                payload["grant_type"] = "authorization_code"
+        if request is None:
+            if headers := request_kwargs.get("headers"):
+                headers = dict(headers, platform="open_platform")
+            else:
+                headers = {"platform": "open_platform"}
+            request_kwargs["headers"] = headers
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("/api/v1/oauth2/access_token", base_url), 
+            method="POST", 
+            params=payload, 
+            **request_kwargs, 
+        )
 
     @overload
-    def fs_trash(
-        self, 
-        payload: dict | int | str | Iterable[int | str], 
+    @staticmethod
+    def login_oauth_verify(
+        payload: dict, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    def fs_trash(
-        self, 
-        payload: dict | int | str | Iterable[int | str], 
+    @staticmethod
+    def login_oauth_verify(
+        payload: dict, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_trash(
-        self, 
-        payload: dict | int | str | Iterable[int | str], 
+    @staticmethod
+    def login_oauth_verify(
+        payload: dict, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """删除文件至回收站
+        """检查 ``appId`` 对应的 ``redirectUri`` 是否可用
 
-        POST https://open-api.123pan.com/api/v1/file/trash
+        POST https://open-api.123pan.com/api/v1/oauth2/app/verify
 
         .. admonition:: Reference
-            /API列表/文件管理/删除/删除文件至回收站
 
-            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/en07662k2kki4bo6
+            /接入指南/第三方挂载应用接入/授权地址
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/gr7ggimkcysm18ap
 
         :payload:
-            - fileIDs: list[int] 💡 文件 id 列表，最多 100 个
+            - appId: str 💡 应用标识，创建应用时分配的 appId
+            - redirectUri: str 💡 回调链接
+            - scope: str = "user:base,file:all:read,file:all:write" 💡 权限
         """
-        api = complete_url("/api/v1/file/trash", base_url)
-        if not isinstance(payload, dict):
-            if isinstance(payload, (int, str)):
-                payload = [payload]
-            elif not isinstance(payload, (tuple, list)):
-                payload = list(payload)
-            payload = {"fileIDs": payload}
-        return self.request(api, "POST", json=payload, async_=async_, **request_kwargs)
+        request_kwargs.setdefault("parse", default_parse)
+        payload = dict_to_lower_merge(payload, scope="user:base,file:all:read,file:all:write")
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("/api/v1/oauth2/app/verify", base_url), 
+            method="POST", 
+            json=payload, 
+            **request_kwargs, 
+        )
 
     ########## Offline Download API ##########
 
@@ -1972,6 +2417,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/offline/download
 
         .. admonition:: Reference
+
             /API列表/离线下载/创建离线下载任务
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/he47hsq2o1xvgado
@@ -2033,6 +2479,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/offline/download/process
 
         .. admonition:: Reference
+
             /API列表/离线下载/获取离线下载进度
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/sclficr3t655pii5
@@ -2086,11 +2533,14 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/oss/source/copy
 
         .. note::
-            说明：图床复制任务创建（可创建的任务数：3，fileIDs 长度限制：100，当前一个任务处理完后将会继续处理下个任务）
-该接口将会复制云盘里的文件或目录对应的图片到对应图床目录，每次任务包含的图片总数限制 1000 张，图片格式：png, gif, jpeg, tiff, webp,jpg,tif,svg,bmp，图片大小限制：100M，文件夹层级限制：15层
-如果图床目录下存在相同 etag、size 的图片将会视为同一张图片，将覆盖原图片
+            图床复制任务创建（可创建的任务数：3，fileIDs 长度限制：100，当前一个任务处理完后将会继续处理下个任务）。
+
+            该接口将会复制云盘里的文件或目录对应的图片到对应图床目录，每次任务包含的图片总数限制 1000 张，图片格式：png, gif, jpeg, tiff, webp,jpg,tif,svg,bmp，图片大小限制：100M，文件夹层级限制：15层。
+
+            如果图床目录下存在相同 etag、size 的图片将会视为同一张图片，将覆盖原图片
 
         .. admonition:: Reference
+
             /API列表/图床/复制云盘图片/创建复制任务
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/trahy3lmds4o0i3r
@@ -2151,6 +2601,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/oss/source/copy/process
 
         .. admonition:: Reference
+
             /API列表/图床/复制云盘图片/获取复制任务详情
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/rissl4ewklaui4th
@@ -2199,6 +2650,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/oss/source/copy/fail
 
         .. admonition:: Reference
+
             /API列表/图床/复制云盘图片/获取复制失败文件列表
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/tlug9od3xlw2w23v
@@ -2253,6 +2705,7 @@ class P123OpenClient:
             彻底删除文件前，文件必须要在回收站中，否则无法删除        
 
         .. admonition:: Reference
+
             /API列表/图床/删除图片
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/ef8yluqdzm2yttdn
@@ -2305,6 +2758,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/oss/file/detail
 
         .. admonition:: Reference
+
             /API列表/图床/获取图片信息/获取图片详情
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/rgf2ndfaxc2gugp8
@@ -2357,6 +2811,7 @@ class P123OpenClient:
             其它则代表下一页开始的文件 id，携带到请求参数中，可查询下一页
 
         .. admonition:: Reference
+
             /API列表/图床/获取图片信息/获取图片列表
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/zayr72q8xd7gg4f8
@@ -2414,6 +2869,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/upload/v1/oss/file/mkdir
 
         .. admonition:: Reference
+
             /API列表/图床/上传图片/创建目录
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/tpqqm04ocqwvonrk
@@ -2468,6 +2924,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/oss/file/move
 
         .. admonition:: Reference
+
             /API列表/图床/移动图片
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/eqeargimuvycddna
@@ -2522,6 +2979,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/oss/offline/download
 
         .. admonition:: Reference
+
             /API列表/图床/图床离线迁移/创建离线迁移任务
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/ctigc3a08lqzsfnq
@@ -2585,6 +3043,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/oss/offline/download/process
 
         .. admonition:: Reference
+
             /API列表/图床/图床离线迁移/获取离线迁移任务
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/svo92desugbyhrgq
@@ -2633,11 +3092,12 @@ class P123OpenClient:
         POST https://open-api.123pan.com/upload/v1/oss/file/create
 
         .. note::
-            - 文件名要小于 256 个字符且不能包含以下字符："\\/:*?|><
+            - 文件名要小于 256 个字符且不能包含以下字符：``"\\/:*?|><``
             - 文件名不能全部是空格
             - 不会重名
 
         .. admonition:: Reference
+
             /API列表/图床/上传图片/创建文件
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/xwfka5kt6vtmgs8r
@@ -2656,10 +3116,10 @@ class P123OpenClient:
             .. code:: python
 
                 {
-                    "fileID": str, # 上传后的文件 id。当已有相同 `size` 和 `etag` 的文件时，会发生秒传
-                    "preuploadID": str, # 预上传 id。当 `reuse` 为 "true" 时，该字段不存在
+                    "fileID": str, # 上传后的文件 id。当已有相同 ``size`` 和 ``etag`` 的文件时，会发生秒传
+                    "preuploadID": str, # 预上传 id。当 ``reuse`` 为 "true" 时，该字段不存在
                     "reuse": bool, # 是否秒传，返回 "true" 时表示文件已上传成功
-                    "sliceSize": int, # 分片大小，必须按此大小生成文件分片再上传。当 `reuse` 为 "true" 时，该字段不存在
+                    "sliceSize": int, # 分片大小，必须按此大小生成文件分片再上传。当 ``reuse`` 为 "true" 时，该字段不存在
                 }
         """
         api = complete_url("/upload/v1/oss/file/create", base_url)
@@ -2707,6 +3167,7 @@ class P123OpenClient:
             有多个分片时，轮流分别根据序号获取下载链接，然后 PUT 方法上传分片。由于上传链接会过期，所以没必要提前获取一大批
 
         .. admonition:: Reference
+
             /API列表/图床/上传图片/获取上传地址&上传分片
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/pyfo3a39q6ac0ocd
@@ -2800,6 +3261,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/upload/v1/oss/file/upload_complete
 
         .. admonition:: Reference
+
             /API列表/图床/上传图片/上传完毕
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/yhgo0kt3nkngi8r2
@@ -2859,6 +3321,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/upload/v1/oss/file/upload_async_result
 
         .. admonition:: Reference
+
             /API列表/图床/上传图片/异步轮询获取上传结果
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/lbdq2cbyzfzayipu
@@ -2939,27 +3402,28 @@ class P123OpenClient:
         """上传文件
 
         .. note::
-            如果文件名中包含字符 "\\/:*?|><，则转换为对应的全角字符
+            如果文件名中包含字符 ``"\\/:*?|><``，则转换为对应的全角字符
 
         .. admonition:: Reference
+
             /API列表/图床/上传图片/💡上传流程说明
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/di0url3qn13tk28t
 
         :param file: 待上传的文件
 
-            - 如果为 `collections.abc.Buffer`，则作为二进制数据上传
-            - 如果为 `filewrap.SupportsRead`，则作为可读的二进制文件上传
-            - 如果为 `str` 或 `os.PathLike`，则视为路径，打开后作为文件上传
-            - 如果为 `yarl.URL` 或 `http_request.SupportsGeturl` (`pip install python-http_request`)，则视为超链接，打开后作为文件上传
-            - 如果为 `collections.abc.Iterable[collections.abc.Buffer]` 或 `collections.abc.AsyncIterable[collections.abc.Buffer]`，则迭代以获取二进制数据，逐步上传
+            - 如果为 ``collections.abc.Buffer``，则作为二进制数据上传
+            - 如果为 ``filewrap.SupportsRead``，则作为可读的二进制文件上传
+            - 如果为 ``str`` 或 ``os.PathLike``，则视为路径，打开后作为文件上传
+            - 如果为 ``yarl.URL`` 或 ``http_request.SupportsGeturl`` (``pip install python-http_request``)，则视为超链接，打开后作为文件上传
+            - 如果为 ``collections.abc.Iterable[collections.abc.Buffer]`` 或 ``collections.abc.AsyncIterable[collections.abc.Buffer]``，则迭代以获取二进制数据，逐步上传
 
         :param file_md5: 文件的 MD5 散列值
         :param file_name: 文件名
         :param file_size: 文件大小
         :param parent_id: 要上传的目标目录，默认为根目录
         :param duplicate: 处理同名：0: 提示/忽略 1: 保留两者 2: 替换
-        :param preupload_id: 预上传 id，用于断点续传，提供此参数，则会忽略 `file_md5`、`file_name`、`file_size`、`parent_id` 和 `duplicate`
+        :param preupload_id: 预上传 id，用于断点续传，提供此参数，则会忽略 ``file_md5``、``file_name``、``file_size``、``parent_id`` 和 ``duplicate``
         :param slice_size: 分块大小，断点续传时，如果只上传过少于 2 个分块时，会被使用
         :param async_: 是否异步
         :param request_kwargs: 其它请求参数
@@ -3223,6 +3687,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/share/create
 
         .. admonition:: Reference
+
             /API列表/分享管理/创建分享链接
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/dwd2ss0qnpab5i5s
@@ -3230,7 +3695,7 @@ class P123OpenClient:
         :payload:
             - fileIDList: str 💡 分享文件 id 列表，最多 100 个，用逗号,分隔连接
             - shareExpire: 0 | 1 | 7 | 30 = 0 💡 分享链接有效期天数，0 为永久
-            - shareName: str 💡 分享链接名称，须小于 35 个字符且不能包含特殊字符 "\\/:*?|><
+            - shareName: str 💡 分享链接名称，须小于 35 个字符且不能包含特殊字符 ``"\\/:*?|><``
             - sharePwd: str = "" 💡 设置分享链接提取码
             - trafficLimit: int = <default> 💡 免登陆限制流量，单位：字节
             - trafficLimitSwitch: 1 | 2 = <default> 💡 免登录流量限制开关：1:关闭 2:打开
@@ -3276,6 +3741,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/share/content-payment/create
 
         .. admonition:: Reference
+
             /API列表/分享管理/创建付费分享链接
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/qz30c5k2npe8l98r
@@ -3285,7 +3751,7 @@ class P123OpenClient:
             - isReward: 0 | 1 = 0    💡 是否开启打赏
             - payAmount: int = 1     💡 金额，从 1 到 99，单位：元
             - resourceDesc: str = "" 💡 资源描述
-            - shareName: str         💡 分享链接名称，须小于 35 个字符且不能包含特殊字符 "\\/:*?|><
+            - shareName: str         💡 分享链接名称，须小于 35 个字符且不能包含特殊字符 ``"\\/:*?|><``
         """
         api = complete_url("/api/v1/share/content-payment/create", base_url)
         payload = dict_to_lower_merge(payload, {"payAmount": 1, "isReward": 0, "resourceDesc": ""})
@@ -3327,6 +3793,7 @@ class P123OpenClient:
         PUT https://open-api.123pan.com/api/v1/share/list/info
 
         .. admonition:: Reference
+
             /API列表/分享管理/修改分享链接
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/ga6hhca1u8v9yqx0
@@ -3382,6 +3849,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/share/list
 
         .. admonition:: Reference
+
             /API列表/分享管理/获取分享链接列表
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/ixg0arldi61fe7av
@@ -3433,6 +3901,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/transcode/delete
 
         .. admonition:: Reference
+
             /API列表/视频转码/删除视频/删除转码视频
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/tg2xgotkgmgpulrp
@@ -3484,6 +3953,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/transcode/file/download
 
         .. admonition:: Reference
+
             /API列表/视频转码/视频文件下载/原文件下载
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/mlltlx57sty6g9gf
@@ -3535,6 +4005,7 @@ class P123OpenClient:
             该接口需要轮询去查询结果，建议 10s 一次
 
         .. admonition:: Reference
+
             /API列表/视频转码/视频文件下载/某个视频全部转码文件下载
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/yb7hrb0x2gym7xic
@@ -3585,6 +4056,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/transcode/m3u8_ts/download
 
         .. admonition:: Reference
+
             /API列表/视频转码/视频文件下载/单个转码文件下载（m3u8或ts）
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/yf97p60yyzb8mzbr
@@ -3631,6 +4103,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/transcode/folder/info
 
         .. admonition:: Reference
+
             /API列表/视频转码/获取视频信息/获取转码空间文件夹信息
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/kaalgke88r9y7nlt
@@ -3674,9 +4147,10 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/video/transcode/list
 
         .. attention::
-            此接口仅限授权 `access_token` 调用
+            此接口仅限授权 ``access_token`` 调用
 
         .. admonition:: Reference
+
             /API列表/视频转码/获取视频信息/视频转码列表（三方挂载应用授权使用）
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/tgg6g84gdrmyess5
@@ -3725,6 +4199,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/transcode/video/record
 
         .. admonition:: Reference
+
             /API列表/视频转码/查询转码信息/查询某个视频的转码记录
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/ost1m82sa9chh0mc
@@ -3776,6 +4251,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/transcode/video/resolutions
 
         .. admonition:: Reference
+
             /API列表/视频转码/获取视频信息/获取视频文件可转码的分辨率
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/apzlsgyoggmqwl36
@@ -3824,6 +4300,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/transcode/video/result
 
         .. admonition:: Reference
+
             /API列表/视频转码/查询转码信息/查询某个视频的转码结果
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/iucbqgge0dgfc8sv
@@ -3872,6 +4349,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/transcode/upload/from_cloud_disk
 
         .. admonition:: Reference
+
             /API列表/视频转码/上传视频/云盘上传/从云盘空间上传
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/tqy2xatoo4qmdbz7
@@ -3930,6 +4408,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/api/v1/transcode/video
 
         .. admonition:: Reference
+
             /API列表/视频转码/视频转码/视频转码操作
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/xy42nv2x8wav9n5l
@@ -3981,19 +4460,20 @@ class P123OpenClient:
         POST https://open-api.123pan.com/upload/v1/file/create
 
         .. note::
-            - 文件名要小于 256 个字符且不能包含以下字符："\\/:*?|><
+            - 文件名要小于 256 个字符且不能包含以下字符：``"\\/:*?|><``
             - 文件名不能全部是空格
             - 开发者上传单文件大小限制 10 GB
             - 不会重名
 
         .. admonition:: Reference
+
             /API列表/文件管理/上传/V1/创建文件
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/lrfuu3qe7q1ul8ig
 
         :payload:
             - containDir: "false" | "true" = "false" 💡 上传文件是否包含路径
-            - filename: str 💡 文件名，但 `containDir` 为 "true" 时，视为路径
+            - filename: str 💡 文件名，但 ``containDir`` 为 "true" 时，视为路径
             - duplicate: 0 | 1 | 2 = 0 💡 处理同名：0: 跳过/报错 1: 保留/后缀编号 2: 替换/覆盖
             - etag: str 💡 文件 md5
             - parentFileID: int = 0 💡 父目录 id，根目录是 0
@@ -4005,10 +4485,10 @@ class P123OpenClient:
             .. code:: python
 
                 {
-                    "fileID": str, # 上传后的文件 id。当已有相同 `size` 和 `etag` 的文件时，会发生秒传
-                    "preuploadID": str, # 预上传 id。当 `reuse` 为 "true" 时，该字段不存在
+                    "fileID": str, # 上传后的文件 id。当已有相同 ``size`` 和 ``etag`` 的文件时，会发生秒传
+                    "preuploadID": str, # 预上传 id。当 ``reuse`` 为 "true" 时，该字段不存在
                     "reuse": bool, # 是否秒传，返回 "true" 时表示文件已上传成功
-                    "sliceSize": int, # 分片大小，必须按此大小生成文件分片再上传。当 `reuse` 为 "true" 时，该字段不存在
+                    "sliceSize": int, # 分片大小，必须按此大小生成文件分片再上传。当 ``reuse`` 为 "true" 时，该字段不存在
                 }
         """
         api = complete_url("/upload/v1/file/create", base_url)
@@ -4059,6 +4539,7 @@ class P123OpenClient:
             有多个分片时，轮流分别根据序号获取下载链接，然后 PUT 方法上传分片。由于上传链接会过期，所以没必要提前获取一大批
 
         .. admonition:: Reference
+
             /API列表/文件管理/上传/V1/获取上传地址&上传分片
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/sonz9n085gnz0n3m
@@ -4109,6 +4590,7 @@ class P123OpenClient:
             此接口用于罗列已经上传的分片信息，以供比对
 
         .. admonition:: Reference
+
             /API列表/文件管理/上传/V1/列举已上传分片（非必需）
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/dd28ws4bfn644cny
@@ -4157,6 +4639,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/upload/v1/file/upload_complete
 
         .. admonition:: Reference
+
             /API列表/文件管理/上传/V1/上传完毕
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/hkdmcmvg437rfu6x
@@ -4216,6 +4699,7 @@ class P123OpenClient:
         POST https://open-api.123pan.com/upload/v1/file/upload_async_result
 
         .. admonition:: Reference
+
             /API列表/文件管理/上传/V1/异步轮询获取上传结果
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/qgcosr6adkmm51h7
@@ -4297,9 +4781,10 @@ class P123OpenClient:
         """上传文件
 
         .. note::
-            如果文件名中包含字符 "\\/:*?|><，则转换为对应的全角字符
+            如果文件名中包含字符 ``"\\/:*?|><``，则转换为对应的全角字符
 
         .. admonition:: Reference
+
             /API列表/文件管理/上传/v1/💡上传流程说明
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/il16qi0opiel4889
@@ -4310,18 +4795,18 @@ class P123OpenClient:
 
         :param file: 待上传的文件
 
-            - 如果为 `collections.abc.Buffer`，则作为二进制数据上传
-            - 如果为 `filewrap.SupportsRead`，则作为可读的二进制文件上传
-            - 如果为 `str` 或 `os.PathLike`，则视为路径，打开后作为文件上传
-            - 如果为 `yarl.URL` 或 `http_request.SupportsGeturl` (`pip install python-http_request`)，则视为超链接，打开后作为文件上传
-            - 如果为 `collections.abc.Iterable[collections.abc.Buffer]` 或 `collections.abc.AsyncIterable[collections.abc.Buffer]`，则迭代以获取二进制数据，逐步上传
+            - 如果为 ``collections.abc.Buffer``，则作为二进制数据上传
+            - 如果为 ``filewrap.SupportsRead``，则作为可读的二进制文件上传
+            - 如果为 ``str`` 或 ``os.PathLike``，则视为路径，打开后作为文件上传
+            - 如果为 ``yarl.URL`` 或 ``http_request.SupportsGeturl`` (``pip install python-http_request``)，则视为超链接，打开后作为文件上传
+            - 如果为 ``collections.abc.Iterable[collections.abc.Buffer]`` 或 ``collections.abc.AsyncIterable[collections.abc.Buffer]``，则迭代以获取二进制数据，逐步上传
 
         :param file_md5: 文件的 MD5 散列值
         :param file_name: 文件名
         :param file_size: 文件大小
         :param parent_id: 要上传的目标目录
         :param duplicate: 处理同名：0: 提示/忽略 1: 保留两者 2: 替换
-        :param preupload_id: 预上传 id，用于断点续传，提供此参数，则会忽略 `file_md5`、`file_name`、`file_size`、`parent_id` 和 `duplicate`
+        :param preupload_id: 预上传 id，用于断点续传，提供此参数，则会忽略 ``file_md5``、``file_name``、``file_size``、``parent_id`` 和 ``duplicate``
         :param slice_size: 分块大小，断点续传时，如果只上传过少于 2 个分块时，会被使用
         :param async_: 是否异步
         :param request_kwargs: 其它请求参数
@@ -4582,6 +5067,7 @@ class P123OpenClient:
         GET https://open-api.123pan.com/api/v1/user/info
 
         .. admonition:: Reference
+
             /API列表/用户管理/获取用户信息
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/fa2w0rosunui2v4m
@@ -4606,9 +5092,6 @@ class P123OpenClient:
     ########## API Aliases ##########
 
     login_open = login
-    login_access_token_open = login_access_token
-    login_auth_open = login_auth
-    login_refresh_token_open = login_refresh_token
     dlink_disable_open = dlink_disable
     dlink_enable_open = dlink_enable
     dlink_log_open = dlink_log
@@ -4629,6 +5112,10 @@ class P123OpenClient:
     fs_rename_open = fs_rename
     fs_rename_one_open = fs_rename_one
     fs_trash_open = fs_trash
+    login_token_open = login_token
+    login_oauth_authorize_open = login_oauth_authorize
+    login_oauth_token_open = login_oauth_token
+    login_oauth_verify_open = login_oauth_verify
     offline_download_open = offline_download
     offline_process_open = offline_process
     oss_copy_open = oss_copy
@@ -4674,22 +5161,62 @@ class P123OpenClient:
 class P123Client(P123OpenClient):
     """123 的客户端对象
 
+    .. caution::
+        优先级为：token > passport+password > refresh_token > client_id+client_secret > 扫码
+
+        使用 refresh_token（或者说 oauth 登录），只允许访问 open 接口
+
     :param passport: 手机号或邮箱
     :param password: 密码
     :param token: 123 的访问令牌
+    :param client_id: 应用标识，创建应用时分配的 appId
+    :param client_secret: 应用密钥，创建应用时分配的 secretId
+    :param refresh_token: 刷新令牌
     """
+    passport: int | str = ""
+    password: str = ""
+
     def __init__(
         self, 
         /, 
         passport: int | str | PathLike = "", 
         password: str = "", 
         token: None | str | PathLike = None, 
+        client_id: str = "", 
+        client_secret: str = "", 
+        refresh_token: str = "", 
     ):
-        if isinstance(passport, PathLike):
+        if (isinstance(passport, PathLike) or
+            not token and 
+            isinstance(passport, str) and 
+            len(passport) >= 128
+        ):
             token = passport
+        elif (not refresh_token and 
+            isinstance(passport, str) and 
+            len(passport) >= 48 and 
+            not passport.strip(digits+ascii_uppercase)
+        ):
+            refresh_token = passport
+        elif (not client_id and 
+            isinstance(passport, str) and 
+            len(passport) >= 32 and 
+            not passport.strip(digits+"abcdef")
+        ):
+            client_id = passport
         else:
             self.passport = passport
+        if (not client_secret and 
+            isinstance(password, str) 
+            and len(password) >= 32 and 
+            not password.strip(digits+"abcdef")
+        ):
+            client_secret = password
+        else:
             self.password = password
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self.refresh_token = refresh_token
         if token is None:
             self.login()
         elif isinstance(token, str):
@@ -4702,6 +5229,8 @@ class P123Client(P123OpenClient):
             self._read_token()
             if not self.token:
                 self.login()
+        if not self.passport:
+            self.passport = self.token_user_info["username"]
 
     @overload # type: ignore
     def login(
@@ -4709,7 +5238,11 @@ class P123Client(P123OpenClient):
         /, 
         passport: int | str = "", 
         password: str = "", 
+        client_id: str = "", 
+        client_secret: str = "", 
+        refresh_token: str = "", 
         remember: bool = True, 
+        platform: int = 0, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
@@ -4722,7 +5255,11 @@ class P123Client(P123OpenClient):
         /, 
         passport: int | str = "", 
         password: str = "", 
+        client_id: str = "", 
+        client_secret: str = "", 
+        refresh_token: str = "", 
         remember: bool = True, 
+        platform: int = 0, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[True], 
@@ -4734,7 +5271,11 @@ class P123Client(P123OpenClient):
         /, 
         passport: int | str = "", 
         password: str = "", 
+        client_id: str = "", 
+        client_secret: str = "", 
+        refresh_token: str = "", 
         remember: bool = True, 
+        platform: int = 0, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
@@ -4745,6 +5286,7 @@ class P123Client(P123OpenClient):
         :param passport: 账号
         :param password: 密码
         :param remember: 是否记住密码（不用管）
+        :param platform: 用哪个设备平台扫码
         :param base_url: 接口的基地址
         :param async_: 是否异步
         :param request_kwargs: 其它请求参数
@@ -4759,6 +5301,18 @@ class P123Client(P123OpenClient):
             self.password = password
         else:
             password = self.password
+        if client_id:
+            self.client_id = client_id
+        else:
+            client_id = self.client_id
+        if client_secret:
+            self.client_secret = client_secret
+        else:
+            client_secret = self.client_secret
+        if refresh_token:
+            self.refresh_token = refresh_token
+        else:
+            refresh_token = self.refresh_token
         def gen_step():
             if passport and password:
                 resp = yield self.login_passport(
@@ -4770,8 +5324,17 @@ class P123Client(P123OpenClient):
                 check_response(resp)
                 self.token = resp["data"]["token"]
                 return resp
+            elif client_id and client_secret or refresh_token:
+                return self.login_open(
+                    client_id, 
+                    client_secret, 
+                    refresh_token, 
+                    async_=async_, 
+                    **request_kwargs, 
+                )
             else:
                 resp = yield self.login_with_qrcode(
+                    platform=platform, 
                     base_url=base_url, 
                     async_=async_, 
                     **request_kwargs, 
@@ -4785,6 +5348,7 @@ class P123Client(P123OpenClient):
         self, 
         /, 
         replace: bool | Self = False, 
+        platform: int = 0, 
         base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
@@ -4796,6 +5360,7 @@ class P123Client(P123OpenClient):
         self, 
         /, 
         replace: bool | Self = False, 
+        platform: int = 0, 
         base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[True], 
@@ -4806,6 +5371,7 @@ class P123Client(P123OpenClient):
         self, 
         /, 
         replace: bool | Self = False, 
+        platform: int = 0, 
         base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
@@ -4816,9 +5382,10 @@ class P123Client(P123OpenClient):
         :param replace: 替换某个 client 对象的 token
 
             - 如果为 P123Client, 则更新到此对象
-            - 如果为 True，则更新到 `self`
-            - 如果为 False，否则返回新的 `P123Client` 对象
+            - 如果为 True，则更新到 `self``
+            - 如果为 False，否则返回新的 ``P123Client`` 对象
 
+        :param platform: 用哪个设备平台扫码
         :param base_url: 接口的基地址
         :param async_: 是否异步
         :param request_kwargs: 其它请求参数
@@ -4827,13 +5394,13 @@ class P123Client(P123OpenClient):
         """
         def gen_step():
             resp = yield self.login_qrcode_auto(
+                platform=platform, 
                 base_url=base_url, 
                 async_=async_, 
                 **request_kwargs, 
             )
-            check_response(resp)
             if resp["code"] != 200:
-                raise P123LoginError(EAUTH, resp)
+                raise P123LoginError(errno.EAUTH, resp)
             token = resp["data"]["token"]
             if replace is False:
                 return type(self)(passport=self.passport, password=self.password, token=token)
@@ -4849,6 +5416,7 @@ class P123Client(P123OpenClient):
     def login_qrcode_auto(
         self, 
         /, 
+        platform: int = 0, 
         base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
@@ -4859,6 +5427,7 @@ class P123Client(P123OpenClient):
     def login_qrcode_auto(
         self, 
         /, 
+        platform: int = 0, 
         base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[True], 
@@ -4868,13 +5437,18 @@ class P123Client(P123OpenClient):
     def login_qrcode_auto(
         self, 
         /, 
+        platform: int = 0, 
         base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """执行一次自动扫码，但并不因此更新 `self.token`
+        """执行一次自动扫码，但并不因此更新 ``self.token``
 
+        .. caution::
+            非会员目前只支持同时在线 3 台登录设备
+
+        :param platform: 用哪个设备平台扫码
         :param base_url: 接口的基地址
         :param async_: 是否异步
         :param request_kwargs: 其它请求参数
@@ -4889,6 +5463,14 @@ class P123Client(P123OpenClient):
             )
             check_response(resp)
             uniID = resp["data"]["uniID"]
+            if platform:
+                resp = yield self.login_qrcode_scan(
+                    {"uniID": uniID, "scanPlatform": platform}, 
+                    base_url=base_url, 
+                    async_=async_, 
+                    **request_kwargs, 
+                )
+                check_response(resp)
             resp = yield self.login_qrcode_confirm(
                 uniID, 
                 base_url=base_url, 
@@ -4902,7 +5484,9 @@ class P123Client(P123OpenClient):
                 async_=async_, 
                 **request_kwargs, 
             )
-            return resp
+            check_response(resp)
+            if resp["code"] == 200 or resp["data"]["loginStatus"] not in (0, 1, 3):
+                return resp
         return run_gen_step(gen_step, async_)
 
     @overload
@@ -4974,14 +5558,14 @@ class P123Client(P123OpenClient):
                         print("\r\033[1K[loginStatus=1] qrcode: scanned", end="")
                     case 2:
                         print("\r\033[1K[loginStatus=2] qrcode: cancelled", end="")
-                        raise P123LoginError(EAUTH, f"qrcode: cancelled with {resp!r}")
+                        raise P123LoginError(errno.EAUTH, f"qrcode: cancelled with {resp!r}")
                     case 3:
                         print("\r\033[1K[loginStatus=3] qrcode: login", end="")
                     case 4:
                         print("\r\033[1K[loginStatus=4] qrcode: expired", end="")
-                        raise P123LoginError(EAUTH, f"qrcode: expired with {resp!r}")
+                        raise P123LoginError(errno.EAUTH, f"qrcode: expired with {resp!r}")
                     case _:
-                        raise P123LoginError(EAUTH, f"qrcode: aborted with {resp!r}")
+                        raise P123LoginError(errno.EAUTH, f"qrcode: aborted with {resp!r}")
         return run_gen_step(gen_step, async_)
 
     ########## App API ##########
@@ -5395,7 +5979,7 @@ class P123Client(P123OpenClient):
                     "Etag": "...", # 必填，文件的 MD5
                     "FileID": 0, # 可以随便填
                     "FileName": "a", # 随便填一个名字
-                    "S3KeyFlag": str # 必填，格式为 f"{UID}-0"，UID 就是上传此文件的用户的 UID，如果此文件是由你上传的，则可从 `P123Client.user_info` 的响应中获取
+                    "S3KeyFlag": str # 必填，格式为 f"{UID}-0"，UID 就是上传此文件的用户的 UID，如果此文件是由你上传的，则可从 ``P123Client.user_info`` 的响应中获取
                     "Size": 0, # 可以随便填，填了可能搜索更准确
                 }
 
@@ -5425,10 +6009,10 @@ class P123Client(P123OpenClient):
                 resp["payload"] = payload
                 check_response(resp)
                 if not (info_list := resp["data"]["infoList"]):
-                    raise FileNotFoundError(ENOENT, resp)
+                    raise FileNotFoundError(errno.ENOENT, resp)
                 payload = cast(dict, info_list[0])
                 if payload["Type"]:
-                    raise IsADirectoryError(EISDIR, resp)
+                    raise IsADirectoryError(errno.EISDIR, resp)
             payload = dict_to_lower_merge(
                 payload, {"driveId": 0, "Type": 0, "FileID": 0})
             if "filename" not in payload:
@@ -5479,7 +6063,7 @@ class P123Client(P123OpenClient):
         POST https://www.123pan.com/api/file/batch_download_info
 
         .. warning::
-            会把一些文件或目录以 zip 包的形式下载，但非会员有流量限制，所以还是推荐用 `P123Client.download_info` 逐个获取下载链接并下载
+            会把一些文件或目录以 zip 包的形式下载，但非会员有流量限制，所以还是推荐用 ``P123Client.download_info`` 逐个获取下载链接并下载
 
         :payload:
             - fileIdList: list[FileID]
@@ -5534,15 +6118,15 @@ class P123Client(P123OpenClient):
         """获取下载链接
 
         .. note::
-            `payload` 支持多种格式的输入，按下面的规则按顺序进行判断：
+            ``payload`` 支持多种格式的输入，按下面的规则按顺序进行判断：
 
-            1. 如果是 `int` 或 `str`，则视为文件 id，必须在你的网盘中存在此文件
-            2. 如果是 `dict`（不区分大小写），有 "S3KeyFlag", "Etag" 和 "Size" 的值，则直接获取链接，文件不必在你网盘中
-            3. 如果是 `dict`（不区分大小写），有 "Etag" 和 "Size" 的值，则会先秒传（临时文件路径为 /.tempfile）再获取链接，文件不必在你网盘中
-            4. 如果是 `dict`（不区分大小写），有 "FileID"，则会先获取信息，再获取链接，必须在你的网盘中存在此文件
+            1. 如果是 ``int`` 或 ``str``，则视为文件 id，必须在你的网盘中存在此文件
+            2. 如果是 ``dict`` （不区分大小写），有 "S3KeyFlag", "Etag" 和 "Size" 的值，则直接获取链接，文件不必在你网盘中
+            3. 如果是 ``dict`` （不区分大小写），有 "Etag" 和 "Size" 的值，则会先秒传（临时文件路径为 /.tempfile）再获取链接，文件不必在你网盘中
+            4. 如果是 ``dict`` （不区分大小写），有 "FileID"，则会先获取信息，再获取链接，必须在你的网盘中存在此文件
             5. 否则会报错 ValueError
 
-        :params payload: 文件 id 或者文件信息，文件信息必须包含的信息如下：
+        :param payload: 文件 id 或者文件信息，文件信息必须包含的信息如下：
 
             - FileID: int | str 💡 下载链接
             - S3KeyFlag: str    💡 s3 存储名
@@ -5550,8 +6134,8 @@ class P123Client(P123OpenClient):
             - Size: int         💡 文件大小
             - FileName: str     💡 默认用 Etag（即 MD5）作为文件名，可以省略
 
-        :params async_: 是否异步
-        :params request_kwargs: 其它请求参数
+        :param async_: 是否异步
+        :param request_kwargs: 其它请求参数
 
         :return: 下载链接
         """
@@ -5564,10 +6148,10 @@ class P123Client(P123OpenClient):
                         resp = yield self.fs_info(fileid, async_=async_, **request_kwargs)
                         check_response(resp)
                         if not (info_list := resp["data"]["infoList"]):
-                            raise P123OSError(ENOENT, resp)
+                            raise P123OSError(errno.ENOENT, resp)
                         info = info_list[0]
                         if info["Type"]:
-                            raise IsADirectoryError(EISDIR, resp)
+                            raise IsADirectoryError(errno.EISDIR, resp)
                         payload = dict_to_lower_merge(payload, info)
                     else:
                         raise ValueError("`Size` and `Etag` must be provided")
@@ -5585,7 +6169,7 @@ class P123Client(P123OpenClient):
                     )
                     check_response(resp)
                     if not resp["data"]["Reuse"]:
-                        raise P123OSError(ENOENT, resp)
+                        raise P123OSError(errno.ENOENT, resp)
                     payload["s3keyflag"] = resp["data"]["Info"]["S3KeyFlag"]
                 resp = yield self.download_info(
                     payload, 
@@ -5684,7 +6268,7 @@ class P123Client(P123OpenClient):
         POST https://www.123pan.com/api/restful/goapi/v1/file/copy/async
 
         :payload:
-            - fileList: list[File] 💡 信息可以取自 `P123Client.fs_info` 接口
+            - fileList: list[File] 💡 信息可以取自 ``P123Client.fs_info`` 接口
 
                 .. code:: python
 
@@ -5708,7 +6292,7 @@ class P123Client(P123OpenClient):
                 check_response(resp)
                 info_list = resp["data"]["infoList"]
                 if not info_list:
-                    raise FileNotFoundError(ENOENT, resp)
+                    raise FileNotFoundError(errno.ENOENT, resp)
                 payload = {"fileList": info_list}
             payload = dict_to_lower_merge(payload, targetFileId=parent_id)
             return self.request(
@@ -6006,7 +6590,7 @@ class P123Client(P123OpenClient):
                 - "syncFileList": 同步空间
 
             - operateType: int | str = <default> 💡 操作类型，如果在同步空间，则需要指定为 "SyncSpacePage"
-            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
+            - SearchData: str = <default> 💡 搜索关键字（将无视 ``parentFileId`` 参数）
             - OnlyLookAbnormalFile: int = <default>
         """
         if isinstance(payload, (int, str)):
@@ -6117,9 +6701,9 @@ class P123Client(P123OpenClient):
             - operateType: int | str = <default> 💡 操作类型，如果在同步空间，则需要指定为 "SyncSpacePage"
 
                 .. note::
-                    这个值似乎不影响结果，所以可以忽略。我在浏览器中，看到罗列根目录为 1，搜索（指定 `SearchData`）为 2，同步空间的根目录为 3，罗列其它目录大多为 4，偶尔为 8，也可能是其它值
+                    这个值似乎不影响结果，所以可以忽略。我在浏览器中，看到罗列根目录为 1，搜索（指定 ``SearchData``）为 2，同步空间的根目录为 3，罗列其它目录大多为 4，偶尔为 8，也可能是其它值
 
-            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
+            - SearchData: str = <default> 💡 搜索关键字（将无视 ``parentFileId`` 参数）
             - OnlyLookAbnormalFile: int = 0 💡 大概可传入 0 或 1
         """
         if not isinstance(payload, dict):
@@ -6222,9 +6806,9 @@ class P123Client(P123OpenClient):
             - operateType: int | str = <default> 💡 操作类型，如果在同步空间，则需要指定为 "SyncSpacePage"
 
                 .. note::
-                    这个值似乎不影响结果，所以可以忽略。我在浏览器中，看到罗列根目录为 1，搜索（指定 `SearchData`）为 2，同步空间的根目录为 3，罗列其它目录大多为 4，偶尔为 8，也可能是其它值
+                    这个值似乎不影响结果，所以可以忽略。我在浏览器中，看到罗列根目录为 1，搜索（指定 ``SearchData``）为 2，同步空间的根目录为 3，罗列其它目录大多为 4，偶尔为 8，也可能是其它值
 
-            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
+            - SearchData: str = <default> 💡 搜索关键字（将无视 ``parentFileId`` 参数）
             - OnlyLookAbnormalFile: int = 0 💡 大概可传入 0 或 1
             - RequestSource: int = <default> 💡 浏览器中，在同步空间中为 1
         """
@@ -6605,9 +7189,9 @@ class P123Client(P123OpenClient):
             - operateType: int | str = <default> 💡 操作类型，如果在同步空间，则需要指定为 "SyncSpacePage"
 
                 .. note::
-                    这个值似乎不影响结果，所以可以忽略。我在浏览器中，看到罗列根目录为 1，搜索（指定 `SearchData`）为 2，同步空间的根目录为 3，罗列其它目录大多为 4，偶尔为 8，也可能是其它值
+                    这个值似乎不影响结果，所以可以忽略。我在浏览器中，看到罗列根目录为 1，搜索（指定 ``SearchData``）为 2，同步空间的根目录为 3，罗列其它目录大多为 4，偶尔为 8，也可能是其它值
 
-            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
+            - SearchData: str = <default> 💡 搜索关键字（将无视 ``parentFileId`` 参数）
             - OnlyLookAbnormalFile: int = 0 💡 大概可传入 0 或 1
         """
         if not isinstance(payload, dict):
@@ -6727,7 +7311,7 @@ class P123Client(P123OpenClient):
         POST https://www.123pan.com/api/file/trash
 
         :payload:
-            - fileTrashInfoList: list[File] 💡 信息可以取自 `P123Client.fs_info` 接口
+            - fileTrashInfoList: list[File] 💡 信息可以取自 ``P123Client.fs_info`` 接口
 
                 .. code:: python
 
@@ -7261,11 +7845,11 @@ class P123Client(P123OpenClient):
 
         :payload:
             - uniID: str 💡 二维码 id
-            - scanPlatform: int = 4 💡 扫码的平台代码，微信是 4
+            - scanPlatform: int = 0 💡 扫码的平台代码，部分已知：4:微信 7:android
         """
         if not isinstance(payload, dict):
             payload = {"uniID": payload}
-        payload.setdefault("scanPlatform", 4)
+        payload.setdefault("scanPlatform", 0)
         request_kwargs.setdefault("parse", default_parse)
         if request is None:
             request = get_default_request()
@@ -7462,7 +8046,7 @@ class P123Client(P123OpenClient):
         POST https://www.123pan.com/api/offline_download/task/resolve
 
         :payload:
-            - urls: str = <default> 💡 下载链接，多个用 "\n" 隔开（用于新建链接下载任务）
+            - urls: str = <default> 💡 下载链接，多个用 "\\n" 隔开（用于新建链接下载任务）
             - info_hash: str = <default> 💡 种子文件的 info_hash（用于新建BT任务）
         """
         if isinstance(payload, str):
@@ -7621,7 +8205,7 @@ class P123Client(P123OpenClient):
         POST https://www.123pan.com/api/share/delete
 
         :payload:
-            - shareInfoList: list[ShareID] 💡 信息可以取自 `P123Client.fs_info` 接口
+            - shareInfoList: list[ShareID] 💡 信息可以取自 ``P123Client.fs_info`` 接口
 
                 .. code:: python
 
@@ -7821,7 +8405,7 @@ class P123Client(P123OpenClient):
 
             如果文件在 100MB 以内，下载时是不需要登录的；如果超过 100 MB，但分享者设置的免登录流量包未告罄，下载时也不需要登录
 
-            你也可以使用 `P123Client.download_info` 来获取下载链接，则不需要提供 "ShareKey" 和 "SharePwd"
+            你也可以使用 ``P123Client.download_info`` 来获取下载链接，则不需要提供 "ShareKey" 和 "SharePwd"
 
         :payload:
             - ShareKey: str 💡 分享码
@@ -8164,7 +8748,7 @@ class P123Client(P123OpenClient):
             - Page: int = <default> 💡 第几页，从 1 开始，可以是 0
             - event: str = "shareListFile"
             - operateType: int | str = <default>
-            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
+            - SearchData: str = <default> 💡 搜索关键字（将无视 ``parentFileId`` 参数）
         """
         if isinstance(payload, int):
             payload = {"Page": payload}
@@ -8234,7 +8818,7 @@ class P123Client(P123OpenClient):
             - Page: int = <default> 💡 第几页，从 1 开始，可以是 0
             - event: str = "shareListFile"
             - operateType: int | str = <default>
-            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
+            - SearchData: str = <default> 💡 搜索关键字（将无视 ``parentFileId`` 参数）
         """
         if isinstance(payload, int):
             payload = {"Page": payload}
@@ -8627,7 +9211,7 @@ class P123Client(P123OpenClient):
             - parentFileId: int | str = 0 💡 父目录 id
             - size: int = 0 💡 文件大小，单位：字节
             - type: 0 | 1 = 1 💡 类型，如果是目录则是 1，如果是文件则是 0
-            - NotReuse: bool = False 💡 不要重用（仅在 `type=1` 时有效，如果为 False，当有重名时，立即返回，此时 `duplicate` 字段无效）
+            - NotReuse: bool = False 💡 不要重用（仅在 `type=1` 时有效，如果为 False，当有重名时，立即返回，此时 ``duplicate`` 字段无效）
             - ...
         """
         if isinstance(payload, str):
@@ -8706,15 +9290,15 @@ class P123Client(P123OpenClient):
         """上传文件
 
         .. note::
-            如果文件名中包含字符 "\\/:*?|><，则转换为对应的全角字符
+            如果文件名中包含字符 ``"\\/:*?|><``，则转换为对应的全角字符
 
         :param file: 待上传的文件
 
-            - 如果为 `collections.abc.Buffer`，则作为二进制数据上传
-            - 如果为 `filewrap.SupportsRead`，则作为可读的二进制文件上传
-            - 如果为 `str` 或 `os.PathLike`，则视为路径，打开后作为文件上传
-            - 如果为 `yarl.URL` 或 `http_request.SupportsGeturl` (`pip install python-http_request`)，则视为超链接，打开后作为文件上传
-            - 如果为 `collections.abc.Iterable[collections.abc.Buffer]` 或 `collections.abc.AsyncIterable[collections.abc.Buffer]`，则迭代以获取二进制数据，逐步上传
+            - 如果为 ``collections.abc.Buffer``，则作为二进制数据上传
+            - 如果为 ``filewrap.SupportsRead``，则作为可读的二进制文件上传
+            - 如果为 ``str`` 或 ``os.PathLike``，则视为路径，打开后作为文件上传
+            - 如果为 ``yarl.URL`` 或 ``http_request.SupportsGeturl`` (``pip install python-http_request``)，则视为超链接，打开后作为文件上传
+            - 如果为 ``collections.abc.Iterable[collections.abc.Buffer]`` 或 ``collections.abc.AsyncIterable[collections.abc.Buffer]``，则迭代以获取二进制数据，逐步上传
 
         :param file_md5: 文件的 MD5 散列值
         :param file_name: 文件名
@@ -8978,11 +9562,11 @@ class P123Client(P123OpenClient):
 
         :param file: 待上传的文件
 
-            - 如果为 `collections.abc.Buffer`，则作为二进制数据上传
-            - 如果为 `filewrap.SupportsRead`，则作为可读的二进制文件上传
-            - 如果为 `str` 或 `os.PathLike`，则视为路径，打开后作为文件上传
-            - 如果为 `yarl.URL` 或 `http_request.SupportsGeturl` (`pip install python-http_request`)，则视为超链接，打开后作为文件上传
-            - 如果为 `collections.abc.Iterable[collections.abc.Buffer]` 或 `collections.abc.AsyncIterable[collections.abc.Buffer]`，则迭代以获取二进制数据，逐步上传
+            - 如果为 ``collections.abc.Buffer``，则作为二进制数据上传
+            - 如果为 ``filewrap.SupportsRead``，则作为可读的二进制文件上传
+            - 如果为 ``str`` 或 ``os.PathLike``，则视为路径，打开后作为文件上传
+            - 如果为 ``yarl.URL`` 或 ``http_request.SupportsGeturl`` (``pip install python-http_request``)，则视为超链接，打开后作为文件上传
+            - 如果为 ``collections.abc.Iterable[collections.abc.Buffer]`` 或 ``collections.abc.AsyncIterable[collections.abc.Buffer]``，则迭代以获取二进制数据，逐步上传
 
         :param file_md5: 文件的 MD5 散列值
         :param file_name: 文件名
@@ -9320,6 +9904,8 @@ with temp_globals():
                 CLIENT_API_METHODS_MAP[api] = [name]
 
 
+# TODO: 只有在使用密码登录的情况下，即使 token 失效，也可以重新登录（在有账号和密码的情况下，遇到 401 报错，会自动重新登录（需要加锁））
+# TODO: 新的上传方法需要封装：https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/xogi45g7okqk7svr
 # TODO: 对于某些工具的接口封装，例如 重复文件清理
 # TODO: 同步空间
 # TODO: 直链空间