发送频道图片消息

开发中

POST

https://chat.xiaoheihe.cn/chatroom/v2/channel_msg/send

请求参数

Authorization

在 header 添加参数

token

示例：

token: ********************

Query 参数

client_type

string

声明请求黑盒语音

必需

默认值:

heybox_chat

x_client_type

string

声明客户端类型

必需

默认值:

web

os_type

string

声明客户端类型

必需

默认值:

web

x_os_type

string

声明客户端是bot

必需

默认值:

bot

x_app

string

声明请求黑盒语音

必需

默认值:

heybox_chat

chat_os_type

string

声明客户端是bot

必需

默认值:

bot

chat_version

string

必需

客户端版本号,不同版本返回的结果可能有区别

默认值:

1.30.0

Header 参数

Content-Type

string

必需

示例值:

application/json;charset=UTF-8

Body 参数application/json

msg

string

文字消息内容

必需

msg_type

integer

必需

消息类型： 1: 文本 3: 图片 4: markdown 10: 支持AT的markdown

heychat_ack_id

string

必需

防止重复发送,建议维护一个全局唯一递增的值

reply_id

string

回复的消息ID

可选

room_id

string

发送消息的房间ID

必需

addition

string

必需

需要用json.dumps转换成字符串再填充, 图片建议在addition添加width和height

at_user_id

string

可选

AT的用户ID列表"123,234"

at_role_id

string

可选

AT的角色ID列表"123,234"

mention_channel_id

string

可选

提及的频道ID"123456",可以直接跳转到某个频道

channel_id

string

发送消息的频道ID

必需

img

string

可选

图片地址发送图片时是必须

示例

{
    "heychat_ack_id": "0",
    "msg_type": 3,
    "img": "https://chat.max-c.com/pic/1793554163917103104.png",
    "addition": "{\"img_files_info\":[{\"url\":\"https://chat.max-c.com/pic/1793554163917103104.png\",\"width\":194,\"height\":228}]}",
    "channel_id": "3377790315288076288",
    "room_id": "3365307913282265088",
    "reply_id": ""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://chat.xiaoheihe.cn/chatroom/v2/channel_msg/send?client_type=&x_client_type=&os_type=&x_os_type=&x_app=&chat_os_type=&chat_version=' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'token;' \
--data-raw '{
    "heychat_ack_id": "0",
    "msg_type": 3,
    "img": "https://chat.max-c.com/pic/1793554163917103104.png",
    "addition": "{\"img_files_info\":[{\"url\":\"https://chat.max-c.com/pic/1793554163917103104.png\",\"width\":194,\"height\":228}]}",
    "channel_id": "3377790315288076288",
    "room_id": "3365307913282265088",
    "reply_id": ""
}'

返回响应

🟢200成功

application/json

Body

msg

string

必需

result

object

必需

chatmobile_ack_id

string

必需

heychat_ack_id

string

必需

status

string

必需

示例

{
    "msg": "string",
    "result": {
        "chatmobile_ack_id": "string",
        "heychat_ack_id": "string"
    },
    "status": "string"
}

修改于 2024-10-09 08:31:32

给用户发送私聊消息

发送频道消息