发送消息 (GET) - go-wechat-http

请求参数

Query 参数

action

string

必需

固定为 'send_message'

示例值:

send_message

echo

string

原样返回字段

可选

示例值:

my_echo_get_1

message_type

string

可选

示例值:

private

user_id

string

可选

示例值:

wxid_targetuser

group_id

string

可选

示例值:

targetgroup@chatroom

send_id

string

可选

示例值:

wxid_compat_send

message

string

必需

消息段数组 (作为查询参数时，通常需要进行 JSON 序列化并 URL 编码。例如，一个包含单个文本消息段的数组 [{"type":"text","data":{"text":"Hello GET"}}] 序列化并编码后附加到URL)

示例值:

[{"type":"text","data":{"text":"Hello via GET"}}]

group_ids

string

可选

群组标签ID列表 (例如 group_ids=id1,id2 或 JSON 序列化的数组)

示例值:

label_X,label_Y

Header 参数

Authorization

string

必需

认证Token，例如：Bearer YOUR_TOKEN

示例值:

Bearer YOUR_TOKEN

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request GET 'http://127.0.0.1:10614/send_message?action=send_message&message=[{"type":"text","data":{"text":"Hello via GET"}}]' \
--header 'Authorization: Bearer YOUR_TOKEN'

返回响应

🟢200操作结果

application/json

Body

status

enum<string>

执行状态

必需

枚举值:

okfailed

示例值:

ok

retcode

integer <int64>

必需

返回码 (0 为成功, 其他为错误码，具体定义见 oneboterr 包)

示例值:

0

message

string

可选

错误信息 (仅在 status 为 'failed' 时有效)

示例值:

参数无效

echo

string

可选

原样返回的 echo 字段

示例值:

request_echo_123

data

object

MsgRespData

可选

发送消息成功时的响应数据

time

number <double>

时间戳

可选

示例值:

1678886400.123

message_id

string

可选

消息 ID (通常是虚拟生成的)

示例值:

abc-123-def-456

示例

{
    "status": "ok",
    "retcode": 0,
    "data": {
        "message_id": "another-uuid",
        "time": 1625884300
    },
    "echo": "my_echo_get_1"
}