go-wechat-http

处理好友请求

POST

http://127.0.0.1:10614/handle_friend_request

请求参数

Header 参数

Authorization

string

必需

认证Token，例如：Bearer YOUR_TOKEN

示例值:

Bearer {{ACCESS_TOKEN}}

Content-Type

string

请求体的内容类型

必需

示例值:

application/json

Body 参数application/json

action

string

动作名称

必需

示例值:

handle_friend_request

params

object

HandleFriendRequestParams

必需

handle_friend_request 动作的参数

flag

string

必需

好友请求的标识 (通常是来自 friend_request 事件的 v4 ticket)

示例值:

v4_xxxxxxxxxxxxxxxxxxxxxx@stranger

approve

boolean

必需

是否同意请求 (true: 同意, false: 拒绝)

示例值:

true

remark

string

可选

同意好友请求时的备注名 (可选)

示例值:

微信好友-小明

ticket_v3

string

必需

好友请求的 v3 ticket (来自 friend_request 事件)

示例值:

v3_yyyyyyyyyyyyyyyyyyyyyy@stranger

scene

integer <int64>

必需

好友请求的场景值 (来自 friend_request 事件)

示例值:

echo

string

原样返回字段

可选

示例值:

request_echo_123

示例

{
    "action": "handle_friend_request",
    "params": {
        "flag": "v4_ticket_example_from_event@stranger",
        "approve": true,
        "remark": "来自API的备注",
        "ticket_v3": "v3_ticket_example_from_event@stranger",
        "scene": 14
    },
    "echo": "echo_handle_friend_req"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1:10614/handle_friend_request' \
--header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "handle_friend_request",
    "params": {
        "flag": "v4_ticket_example_from_event@stranger",
        "approve": true,
        "remark": "来自API的备注",
        "ticket_v3": "v3_ticket_example_from_event@stranger",
        "scene": 14
    },
    "echo": "echo_handle_friend_req"
}'

返回响应

🟢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

成功时为空对象

可选

示例

{
    "status": "ok",
    "retcode": 0,
    "data": {},
    "echo": "echo_handle_friend_req"
}

获取成员所在分组 (GET)

获取聊天图片