获取群/好友简要信息

GeHub 接入说明（Token、节点和幂等要求）

X-GEHUB-TOKEN 请在后台「客户端」创建或重置凭据后复制（不是 Client Secret 本身），仅通过 HTTPS 发送。节点由客户端默认绑定决定，appId 为兼容占位，不用于选择节点。写操作必须提供新的 Idempotency-Key（8–128 位字母、数字、点、下划线、冒号或短横线）；同一操作重试必须复用原值。危险操作另需 X-Confirm-Risk: destructive。首次微信登录和回调配置请在后台完成。客户端需启用对应模块权限。

POST

/gehub/v2/api/contacts/getBriefInfo

请求参数

Header 参数

X-GEHUB-TOKEN

string

必需

示例:

Body 参数application/json

appId

string

兼容占位，可省略；按客户端绑定选择节点

wxids

array[string]

必需

好友的wxid（最大20个）

>= 1 items<= 100 items

示例

{
    "appId": "{{appid}}",
    "wxids": [
        "wxid_phyyedw9xap22"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://wxapi.xiaoyu.fan/gehub/v2/api/contacts/getBriefInfo' \
--header 'X-GEHUB-TOKEN: {{gehub-token}}' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "",
    "wxids": [
        "wxid_phyyedw9xap22"
    ]
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

ret

integer

必需

msg

string

必需

data

array [object]

必需

userName

string

可选

nickName

string

可选

pyInitial

string

可选

quanPin

string

可选

sex

integer

可选

remark

string

可选

remarkPyInitial

string

可选

remarkQuanPin

string

可选

signature

null

可选

alias

string

可选

snsBgImg

null

可选

country

string

可选

bigHeadImgUrl

string

可选

smallHeadImgUrl

string

可选

description

null

可选

cardImgUrl

null

可选

labelList

string

可选

province

string

可选

city

string

可选

phoneNumList

null

可选

示例

{
    "ret": 200,
    "msg": "获取联系人信息成功",
    "data": [
        {
            "userName": "wxid_phyyedw9xap22",
            "nickName": "Ashley",
            "pyInitial": "ASHLEY",
            "quanPin": "Ashley",
            "sex": 2,
            "remark": "",
            "remarkPyInitial": "",
            "remarkQuanPin": "",
            "signature": null,
            "alias": "zero-one_200906",
            "snsBgImg": null,
            "country": "AD",
            "bigHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/buiaXybHTBK3BuGr1edN72zBDermWVFJ7YC8Jib2RcCSdiauAtZcPgUQpdhE9KY5NsumDAWD16fsg3A6OKuhdEr97VAHdTGgk6R1Eibuj7ZNwJ4/0",
            "smallHeadImgUrl": "https://wx.qlogo.cn/mmhead/ver_1/buiaXybHTBK3BuGr1edN72zBDermWVFJ7YC8Jib2RcCSdiauAtZcPgUQpdhE9KY5NsumDAWD16fsg3A6OKuhdEr97VAHdTGgk6R1Eibuj7ZNwJ4/132",
            "description": null,
            "cardImgUrl": null,
            "labelList": "",
            "province": "",
            "city": "",
            "phoneNumList": null
        }
    ]
}

修改于超过 1 年前

获取通讯录列表缓存

获取群/好友详细信息