消息用法

简体中文 | English
^{语言翻译不一定100%准确}

导入模块

from RyhBotPythonSDK import Message

设置消息令牌(token)

Message.Token = "你可以在云湖后台找到你的消息令牌"

发送消息

Send = Message.Send()

文本

Send.Text(
    recvId = "目标ID",
    recvType = "目标类型",
    text = "文本"
)

Markdown

Send.Markdown(
    recvId = "目标ID",
    recvType = "目标类型",
    markdown = "Markdown语句"
)

图片

Send.Image(
    recvId = "目标ID",
    recvType = "目标类型",
    imagePath = "图片地址"
)

文件

Send.File(
    recvId = "目标ID",
    recvType = "目标类型",
    fileName = "文件名称",
    fileUrl = "文件链接"
)

可选参数

1. buttons: 按钮列表，请访问文档了解更多信息。
2. parentId: 引用消息的ID。

响应

1. code: 响应状态码。
2. msg: 响应信息，包括异常信息。
3. data: 响应数据。

编辑消息

Edit = Message.Edit()

文本

Edit.Text(
    msgId = "消息ID",
    recvId = "目标ID",
    recvType = "目标类型",
    new_text = "新的文本"
)

Markdown

Edit.Markdown(
    msgId = "消息ID",
    recvId = "目标ID",
    recvType = "目标类型",
    new_markdown = "新的Markdown"
)

图片

Edit.Image(
    msgId = "消息ID",
    recvId = "目标ID",
    recvType = "目标类型",
    new_image_path = "新的图片地址"
)

文件

Edit.File(
    msgId = "消息ID",
    recvId = "目标ID",
    recvType = "目标类型",
    new_file_name = "新的文件名称",
    new_file_url = "新的文件链接"
)

可选参数

1. buttons: 按钮列表，请访问文档了解更多信息。

响应

1. code: 响应状态码。
2. msg: 响应信息，包括异常信息。
3. data: 响应数据。

删除消息

Delete = Message.Delete

用法

Delete(
    msgId="消息ID",
    chatId="目标ID",
    chatType="目标类型",
)

响应

1. code：响应状态码。
2. msg：响应信息，包括异常信息。
3. data：响应数据。

获取消息

Messages = Message.Messages()

前向

Messages.Before(
    chat_id = "目标ID",
    chat_type = "目标类型",
    before = 消息数量 # 整型
)

后向

Messages.After(
    chat_id = "目标ID",
    chat_type = "目标类型",
    message_id = "消息ID", # 基于某条消息，获取后续的消息
    after = 消息数量 # 整型
)

响应

1. code：响应状态码。
2. msg：响应信息，包括异常信息。
3. data：响应数据。

管理看板(dashboard)

用户看板

Board = Message.Board()

文本

Board.Text(
    recvId = "目标ID",
    recvType = "目标类型",
    text = "看板文本"
)

Markdown

Board.Markdown(
    recvId = "目标ID",
    recvType = "目标类型",
    markdown = "看板Markdown文本"
)

Html

Board.Html(
    recvId = "目标ID",
    recvType = "目标类型",
    html = "看板HTML文本"
)

可选参数

1. expireTime: 消息的过期时间，单位为秒。

取消看板

Board.Dismiss(
    recvId = "目标ID",
    recvType = "目标类型"
)

全局看板

BoardAll = Message.Board.All()

文本

BoardAll.Text(
    text = "看板文本"
)

Markdown

BoardAll.Markdown(
    markdown = "看板Markdown文本"
)

Html

BoardAll.Html(
    html = "看板HTML文本"
)

可选参数

1. expireTime: 消息的过期时间，单位为秒。

取消看板

BoardAll.Dismiss()
)