go-wechat-http

获取好友列表 (GET)

GET

http://127.0.0.1:10614/get_friend_list

请求参数

Query 参数

action

string

必需

固定为 'get_friend_list'

示例值:

get_friend_list

echo

string

原样返回字段

可选

示例值:

echo_get_friends_get

Header 参数

Authorization

string

必需

认证Token，例如：Bearer YOUR_TOKEN

示例值:

Bearer {{ACCESS_TOKEN}}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'http://127.0.0.1:10614/get_friend_list?action=get_friend_list' \
--header 'Authorization: Bearer {{ACCESS_TOKEN}}'

返回响应

🟢200操作结果

application/json

Body

status

enum<string>

执行状态

必需

枚举值:

okfailed

示例值:

retcode

integer <int64>

必需

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

示例值:

message

string

可选

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

示例值:

参数无效

echo

string

可选

原样返回的 echo 字段

示例值:

request_echo_123

data

array[object (FriendInfo) {5}]

可选

user_id

string

必需

用户ID (wxid)

示例值:

wxid_abcdef123456

nickname

string

用户昵称

必需

示例值:

张三

remark

string

备注名 (可选)

可选

示例值:

开发-张三

_code

string

可选

微信号 (自定义字段，可选)

示例值:

zhangsan_wx

_gender

integer <int64>

可选

性别 (自定义字段，0-未知, 1-男, 2-女，可选)

示例值:

示例

{
    "status": "ok",
    "retcode": 0,
    "data": [
        {
            "user_id": "wxid_user2",
            "nickname": "好友B"
        }
    ],
    "echo": "echo_get_friends_get"
}

获取聊天图片(消息字段chat_img_url中获取)

获取群列表 (GET)