perk-pushplus-sdk 1.2.3__tar.gz → 1.2.4__tar.gz

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: perk-pushplus-sdk
-Version: 1.2.3
+Version: 1.2.4
 Summary: pushplus(推送加) 官方接口的 Python SDK，覆盖消息发送接口与全部开放接口。
 Author: perk-net
 License: Apache-2.0
@@ -35,7 +35,7 @@ Requires-Dist: responses>=0.23; extra == "dev"
 [pushplus(推送加)](https://www.pushplus.plus) 官方接口的 Python SDK，覆盖 **消息接口** 与 **全部开放接口**。
 
 - **消息接口**（`/send`、`/batchSend`）：单渠道 + 多渠道发送，含 Builder API。
-- **开放接口**（`/api/open/...` 与 `/push/api/open/...`）：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、QQ 机器人、功能设置、预处理信息、图片服务、push 表单、push 文档、push 表格、消息规则。
+- **开放接口**（`/api/open/...` 与 `/push/api/open/...`）：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、新消息 ClawBot、QQ 机器人、功能设置、预处理信息、图片服务、push 表单、push 文档、push 表格、消息规则。
 - **AccessKey 自动管理**：缓存 + 过期前自动刷新；`code=401` 自动刷新并重试一次。
 - **本地限流守卫**：命中 `code=900` 后按 token 短路同 token 后续发送，避免被服务端长期封禁。
 - **回调解析**：`message_complate`、`add_topic_user`、`add_friend` 三类回调统一解析。
@@ -168,6 +168,17 @@ topic_blacklist = client.topic_user.blacklist_list(TopicUserListQuery.of(1, 20,
 # webhook 渠道
 webhooks = client.webhook.list()
 
+# 新消息 ClawBot：绑定 Channel API Key 后，channel 传 cmcc（仅中国移动）
+client.cmcc.bind("ak_xxxxxxxxxxxxxxxx")
+cmcc_info = client.cmcc.info()  # cmcc_info.bound == 1 表示已绑定
+client.cmcc.send_test()
+client.send(SendRequest(
+    title="服务告警",
+    content="订单服务响应超时",
+    channel=Channel.CMCC,
+    template=Template.TXT,
+))
+
 # QQ 机器人：绑定 -> 认领群 -> 建配置 -> 发到群
 from perk_pushplus import QqBotSaveRequest
 link = client.qq_bot.get_bind_link()   # link.url 生成二维码，或私聊发送 link.bindCode

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/README.md

@@ -3,7 +3,7 @@
 [pushplus(推送加)](https://www.pushplus.plus) 官方接口的 Python SDK，覆盖 **消息接口** 与 **全部开放接口**。
 
 - **消息接口**（`/send`、`/batchSend`）：单渠道 + 多渠道发送，含 Builder API。
-- **开放接口**（`/api/open/...` 与 `/push/api/open/...`）：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、QQ 机器人、功能设置、预处理信息、图片服务、push 表单、push 文档、push 表格、消息规则。
+- **开放接口**（`/api/open/...` 与 `/push/api/open/...`）：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、新消息 ClawBot、QQ 机器人、功能设置、预处理信息、图片服务、push 表单、push 文档、push 表格、消息规则。
 - **AccessKey 自动管理**：缓存 + 过期前自动刷新；`code=401` 自动刷新并重试一次。
 - **本地限流守卫**：命中 `code=900` 后按 token 短路同 token 后续发送，避免被服务端长期封禁。
 - **回调解析**：`message_complate`、`add_topic_user`、`add_friend` 三类回调统一解析。
@@ -136,6 +136,17 @@ topic_blacklist = client.topic_user.blacklist_list(TopicUserListQuery.of(1, 20,
 # webhook 渠道
 webhooks = client.webhook.list()
 
+# 新消息 ClawBot：绑定 Channel API Key 后，channel 传 cmcc（仅中国移动）
+client.cmcc.bind("ak_xxxxxxxxxxxxxxxx")
+cmcc_info = client.cmcc.info()  # cmcc_info.bound == 1 表示已绑定
+client.cmcc.send_test()
+client.send(SendRequest(
+    title="服务告警",
+    content="订单服务响应超时",
+    channel=Channel.CMCC,
+    template=Template.TXT,
+))
+
 # QQ 机器人：绑定 -> 认领群 -> 建配置 -> 发到群
 from perk_pushplus import QqBotSaveRequest
 link = client.qq_bot.get_bind_link()   # link.url 生成二维码，或私聊发送 link.bindCode

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "perk-pushplus-sdk"
-version = "1.2.3"
+version = "1.2.4"
 description = "pushplus(推送加) 官方接口的 Python SDK，覆盖消息发送接口与全部开放接口。"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.8"

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/__init__.py

@@ -54,6 +54,8 @@ from .models import (
     ClawBotInfo,
     ClawBotMessage,
     ClawBotQrCode,
+    CmccBindRequest,
+    CmccInfo,
     CpItem,
     DocContent,
     DocListItem,
@@ -134,7 +136,7 @@ from .models import (
 )
 from .rate_limit import RateLimitGuard
 
-__version__ = "1.2.3"
+__version__ = "1.2.4"
 
 __all__ = [
     "__version__",
@@ -208,6 +210,8 @@ __all__ = [
     "ClawBotQrCode",
     "ClawBotInfo",
     "ClawBotMessage",
+    "CmccBindRequest",
+    "CmccInfo",
     "QqBotBindLink",
     "QqBotInfo",
     "QqBotBindInfo",

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/api/__init__.py

@@ -3,6 +3,7 @@ from .access_key import AccessKeyApi
 from .base import AbstractApi, OpenAbstractApi
 from .channel import ChannelApi
 from .clawbot import ClawBotApi
+from .cmcc import CmccApi
 from .friend import FriendApi
 from .image import ImageApi
 from .form import FormApi
@@ -35,6 +36,7 @@ __all__ = [
     "WebhookApi",
     "ChannelApi",
     "ClawBotApi",
+    "CmccApi",
     "QqBotApi",
     "SettingApi",
     "PreApi",

perk_pushplus_sdk-1.2.4/src/perk_pushplus/api/cmcc.py

@@ -0,0 +1,38 @@
+"""开放接口 - 新消息 ClawBot（文档「九. 新消息ClawBot接口」）。
+
+需先在手机 5G 消息的「新消息ClawBot」应用号中获取 Channel API Key，再调用绑定接口。
+发送消息时 channel 传 ``cmcc``。仅支持中国移动用户。
+"""
+from __future__ import annotations
+
+from ..models import CmccBindRequest, CmccInfo
+from .base import OpenAbstractApi
+
+
+class CmccApi(OpenAbstractApi):
+    """新消息 ClawBot 渠道相关接口。"""
+
+    def bind(self, api_key: str) -> None:
+        """绑定新消息 ClawBot。``api_key`` 必须以 ``ak_`` 或 ``app_`` 开头。"""
+
+        self.execute_open(
+            "POST", "/api/open/cmcc/bind", CmccBindRequest(apiKey=api_key), None
+        )
+
+    def info(self) -> CmccInfo:
+        """查询绑定状态。"""
+
+        return self.execute_open("GET", "/api/open/cmcc/info", None, CmccInfo)
+
+    def unbind(self) -> None:
+        """解绑新消息 ClawBot。"""
+
+        self.execute_open("GET", "/api/open/cmcc/unbind", None, None)
+
+    def send_test(self) -> None:
+        """发送测试消息。未绑定会返回「未绑定新消息ClawBot」。"""
+
+        self.execute_open("GET", "/api/open/cmcc/test", None, None)
+
+
+__all__ = ["CmccApi"]

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/client.py

@@ -9,6 +9,7 @@ from .api import (
     AccessKeyApi,
     ChannelApi,
     ClawBotApi,
+    CmccApi,
     FriendApi,
     ImageApi,
     MessageApi,
@@ -79,6 +80,7 @@ class PushPlusClient:
         self.webhook = WebhookApi(config, self.http_requester, self.access_key_manager)
         self.channel = ChannelApi(config, self.http_requester, self.access_key_manager)
         self.claw_bot = ClawBotApi(config, self.http_requester, self.access_key_manager)
+        self.cmcc = CmccApi(config, self.http_requester, self.access_key_manager)
         self.qq_bot = QqBotApi(config, self.http_requester, self.access_key_manager)
         self.setting = SettingApi(config, self.http_requester, self.access_key_manager)
         self.pre = PreApi(config, self.http_requester, self.access_key_manager)

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/config.py

@@ -62,7 +62,7 @@ class PushPlusConfig:
     可显式设置 ``2 * 86400`` 等更长值来减少无用试探。
     """
 
-    user_agent: str = "perk-pushplus-python-sdk/1.2.3"
+    user_agent: str = "perk-pushplus-python-sdk/1.2.4"
     """HTTP User-Agent 头。"""
 
     extra_headers: dict = field(default_factory=dict)

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/enums.py

@@ -42,6 +42,8 @@ class Channel(_StrCodeEnum):
     """App 渠道（安卓/鸿蒙/iOS）。"""
     CLAWBOT = "clawbot"
     """微信 ClawBot。"""
+    CMCC = "cmcc"
+    """新消息 ClawBot（中国移动 5G 消息）；仅支持中国移动用户。"""
     QQ = "qq"
     """QQ 机器人；不带 option 发给自己，option 填配置编码则发到对应 QQ 群。"""
 

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus/models/__init__.py

@@ -36,6 +36,7 @@ from .open_friend import FriendBlacklistItem, FriendItem, FriendQrCode
 from .open_webhook import WebhookItem, WebhookSaveRequest
 from .open_channel import CpItem, MailDetail, MailItem, MpItem
 from .open_clawbot import ClawBotInfo, ClawBotMessage, ClawBotQrCode
+from .open_cmcc import CmccBindRequest, CmccInfo
 from .open_qqbot import (
     QqBotBindInfo,
     QqBotBindLink,
@@ -120,6 +121,8 @@ __all__ = [
     "ClawBotQrCode",
     "ClawBotInfo",
     "ClawBotMessage",
+    "CmccBindRequest",
+    "CmccInfo",
     "QqBotBindLink",
     "QqBotInfo",
     "QqBotBindInfo",

perk_pushplus_sdk-1.2.4/src/perk_pushplus/models/open_cmcc.py

@@ -0,0 +1,28 @@
+"""开放接口 - 新消息 ClawBot 模型。"""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class CmccBindRequest:
+    """新消息 ClawBot 绑定请求。"""
+
+    apiKey: str
+    """中国移动新消息 Channel API Key，必须以 ak_ 或 app_ 开头。"""
+
+
+@dataclass
+class CmccInfo:
+    """新消息 ClawBot 绑定状态。"""
+
+    bound: Optional[int] = None
+    """是否已绑定；0-未绑定，1-已绑定。"""
+    apiKeyMasked: Optional[str] = None
+    """脱敏后的 API Key。"""
+    createTime: Optional[str] = None
+    """绑定时间。"""
+
+
+__all__ = ["CmccBindRequest", "CmccInfo"]

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: perk-pushplus-sdk
-Version: 1.2.3
+Version: 1.2.4
 Summary: pushplus(推送加) 官方接口的 Python SDK，覆盖消息发送接口与全部开放接口。
 Author: perk-net
 License: Apache-2.0
@@ -35,7 +35,7 @@ Requires-Dist: responses>=0.23; extra == "dev"
 [pushplus(推送加)](https://www.pushplus.plus) 官方接口的 Python SDK，覆盖 **消息接口** 与 **全部开放接口**。
 
 - **消息接口**（`/send`、`/batchSend`）：单渠道 + 多渠道发送，含 Builder API。
-- **开放接口**（`/api/open/...` 与 `/push/api/open/...`）：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、QQ 机器人、功能设置、预处理信息、图片服务、push 表单、push 文档、push 表格、消息规则。
+- **开放接口**（`/api/open/...` 与 `/push/api/open/...`）：用户、消息、消息 token、群组、群组用户、好友、webhook、渠道、ClawBot、新消息 ClawBot、QQ 机器人、功能设置、预处理信息、图片服务、push 表单、push 文档、push 表格、消息规则。
 - **AccessKey 自动管理**：缓存 + 过期前自动刷新；`code=401` 自动刷新并重试一次。
 - **本地限流守卫**：命中 `code=900` 后按 token 短路同 token 后续发送，避免被服务端长期封禁。
 - **回调解析**：`message_complate`、`add_topic_user`、`add_friend` 三类回调统一解析。
@@ -168,6 +168,17 @@ topic_blacklist = client.topic_user.blacklist_list(TopicUserListQuery.of(1, 20,
 # webhook 渠道
 webhooks = client.webhook.list()
 
+# 新消息 ClawBot：绑定 Channel API Key 后，channel 传 cmcc（仅中国移动）
+client.cmcc.bind("ak_xxxxxxxxxxxxxxxx")
+cmcc_info = client.cmcc.info()  # cmcc_info.bound == 1 表示已绑定
+client.cmcc.send_test()
+client.send(SendRequest(
+    title="服务告警",
+    content="订单服务响应超时",
+    channel=Channel.CMCC,
+    template=Template.TXT,
+))
+
 # QQ 机器人：绑定 -> 认领群 -> 建配置 -> 发到群
 from perk_pushplus import QqBotSaveRequest
 link = client.qq_bot.get_bind_link()   # link.url 生成二维码，或私聊发送 link.bindCode

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/src/perk_pushplus_sdk.egg-info/SOURCES.txt

@@ -16,6 +16,7 @@ src/perk_pushplus/api/access_key.py
 src/perk_pushplus/api/base.py
 src/perk_pushplus/api/channel.py
 src/perk_pushplus/api/clawbot.py
+src/perk_pushplus/api/cmcc.py
 src/perk_pushplus/api/doc.py
 src/perk_pushplus/api/excel.py
 src/perk_pushplus/api/form.py
@@ -39,6 +40,7 @@ src/perk_pushplus/models/callback.py
 src/perk_pushplus/models/open_access.py
 src/perk_pushplus/models/open_channel.py
 src/perk_pushplus/models/open_clawbot.py
+src/perk_pushplus/models/open_cmcc.py
 src/perk_pushplus/models/open_doc.py
 src/perk_pushplus/models/open_form.py
 src/perk_pushplus/models/open_forward.py

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/tests/test_enums_and_exceptions.py

@@ -18,6 +18,7 @@ from perk_pushplus import (
 def test_channel_of_case_insensitive():
     assert Channel.of("WeChat") is Channel.WECHAT
     assert Channel.of("clawbot") is Channel.CLAWBOT
+    assert Channel.of("cmcc") is Channel.CMCC
     assert Channel.of(None) is None
     assert Channel.of("not-exist") is None
 

{perk_pushplus_sdk-1.2.3 → perk_pushplus_sdk-1.2.4}/tests/test_open_api.py

@@ -358,6 +358,34 @@ def test_excel_import():
     assert imported.docCode == "Sh3xY7kP"
 
 
+def test_cmcc_bind_and_status():
+    req = ScriptedRequester()
+    req.push("/api/open/cmcc/bind", 200, _ok(None))
+    req.push(
+        "/api/open/cmcc/info",
+        200,
+        _ok({"bound": 1, "apiKeyMasked": "ak_***xxx", "createTime": "2026-09-14 10:20:00"}),
+    )
+    req.push("/api/open/cmcc/test", 200, _ok(None))
+    req.push("/api/open/cmcc/unbind", 200, _ok(None))
+    client = _build_client(req)
+
+    client.cmcc.bind("ak_xxxxxxxxxxxxxxxx")
+    bind_call = next(c for c in req.calls if "/api/open/cmcc/bind" in c[1])
+    assert bind_call[2]["access-key"] == "ak-1"
+    assert json.loads(bind_call[3])["apiKey"] == "ak_xxxxxxxxxxxxxxxx"
+
+    info = client.cmcc.info()
+    assert info.bound == 1
+    assert info.apiKeyMasked == "ak_***xxx"
+
+    client.cmcc.send_test()
+    assert any("/api/open/cmcc/test" in c[1] for c in req.calls)
+
+    client.cmcc.unbind()
+    assert any("/api/open/cmcc/unbind" in c[1] for c in req.calls)
+
+
 def test_qq_bot_bind_and_group_config():
     req = ScriptedRequester()
     req.push(