go-wechat-http

创建分组

POST

http://127.0.0.1:10614/create_group

请求参数

Header 参数

Authorization

string

必需

示例值:

Bearer YOUR_TOKEN

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

action

string

动作名称

必需

示例值:

create_group

params

object

CreateGroupParams

必需

create_group 动作的参数

group_name

string

要创建的分组名称

必需

示例值:

我的新分组

echo

string

原样返回字段

可选

示例值:

request_echo_123

示例

{
    "action": "create_group",
    "params": {
        "group_name": "API 测试分组"
    },
    "echo": "echo_create_group"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1:10614/create_group' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "create_group",
    "params": {
        "group_name": "API 测试分组"
    },
    "echo": "echo_create_group"
}'

返回响应

🟢200操作结果

application/json

Body

status

enum<string>

执行状态

必需

枚举值:

okfailed

示例值:

retcode

integer <int64>

必需

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

示例值:

message

string

可选

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

示例值:

参数无效

echo

string

可选

原样返回的 echo 字段

示例值:

request_echo_123

data

object

Group

可选

分组对象

string

分组ID

必需

示例值:

grp_abc123

name

string

分组名称

必需

示例值:

日常聊天组

示例

{
    "status": "ok",
    "retcode": 0,
    "data": {
        "id": "new_group_id_123",
        "name": "API 测试分组"
    },
    "echo": "echo_create_group"
}

通过分组名称获取分组ID (GET)

删除分组