搜索企微

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

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

POST

/gehub/v2/api/im/search

请求参数

Header 参数

X-GEHUB-TOKEN

string

必需

示例:

Body 参数application/json

appId

string

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

scene

integer

必需

搜索类型 1：企微二维码

content

string

企微二维码信息

必需

示例

{
    "appId": "{{appid}}",
    "scene": 1,
    "content": "https://work.weixin.qq.com/u/vc75a***4e2d?v=4.1.30.167392&bb=83ee2be011"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://wxapi.xiaoyu.fan/gehub/v2/api/im/search' \
--header 'X-GEHUB-TOKEN: {{gehub-token}}' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "",
    "scene": 1,
    "content": "https://work.weixin.qq.com/u/vc75a***4e2d?v=4.1.30.167392&bb=83ee2be011"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

ret

integer

必需

msg

string

必需

data

object

必需

nickName

string

必需

sex

integer

必需

signature

string

必需

bigHeadImgUrl

string

必需

smallHeadImgUrl

string

必需

string

必需

string

必需

示例

{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "nickName": "***",
        "sex": 1,
        "signature": "",
        "bigHeadImgUrl": "https://wework.qpic.c***-K3gHt_1697180185/0",
        "smallHeadImgUrl": "https://wework.qpic.cn/***-K3gHt_1697180185/140",
        "v3": "2598***20@openim",
        "v4": "v1_1045b586**5f68a"
    }
}

修改于将近 2 年前

上传手机通讯录

添加企微好友