扫码关注

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

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

POST

/gehub/v2/api/finder/scanFollow

请求参数

Header 参数

X-GEHUB-TOKEN

string

必需

示例:

Idempotency-Keystring必需

必填，8–128 位；同一操作重试复用原值，新操作换新值。

Body 参数application/json

appId

string

proxyIp

string

必需

myUserName

string

必需

当前用户的userName

myRoleType

integer

必需

身份类型 1：微信 3：视频号

qrContent

string

必需

内容信息二维码链接或对方的userName

objectId

string

必需

如果qrContent 为对方userName 则参数必传，内容从用户主页获取

objectNonceId

string

必需

如果qrContent 为对方userName 则参数必传，内容从用户主页获取

示例

{
    "appId": "{{appid}}",
    "proxyIp":"",
    "myUserName": "v2_060000231003b**8c759a7446a87688c2774e5300c32@finder",
    "myRoleType": 3,
    "qrContent": "v2_060000231003**465d77bc1e1c959b96ccee6e@finder",
    "objectId":"144487526**8757",
    "objectNonceId":"16839900**8113015869"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://wxapi.xiaoyu.fan/gehub/v2/api/finder/scanFollow' \
--header 'X-GEHUB-TOKEN: {{gehub-token}}' \
--header 'Idempotency-Key: {{idempotency-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "",
    "proxyIp":"",
    "myUserName": "v2_060000231003b**8c759a7446a87688c2774e5300c32@finder",
    "myRoleType": 3,
    "qrContent": "v2_060000231003**465d77bc1e1c959b96ccee6e@finder",
    "objectId":"144487526**8757",
    "objectNonceId":"16839900**8113015869"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

ret

integer

必需

msg

string

必需

data

object

必需

username

string

必需

对方的username

nickname

string

昵称

必需

headUrl

string

头像

必需

signature

string

简介

必需

followFlag

integer

必需

authInfo

object

必需

coverImgUrl

string

必需

spamStatus

integer

必需

extFlag

integer

必需

extInfo

object

必需

liveStatus

integer

必需

liveCoverImgUrl

string

必需

liveInfo

object

必需

status

integer

必需

示例

{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "username": "v2_060000231003b20faec8c7e28811c4d5cc0ded37b0779c48c759a7446a87688c2774e5300c32@finder",
        "nickname": "未来可期啊哈",
        "headUrl": "https://wx.qlogo.cn/finderhead/ver_1/D5kOMSrTOprOibFVZ2NOO8AnohFdlDMhoNTZr1C8D9d5K6og92mcc3lxDEFcQldBibqjzIx2iavenQO0TMzhjmrUibmn3iaoaLYtNiaGFWjZgCd5t92shsicTvcyiaIjFjRtwVgy/0",
        "signature": "理智，清醒，知进退。",
        "followFlag": 1,
        "authInfo": {},
        "coverImgUrl": "",
        "spamStatus": 0,
        "extFlag": 262152,
        "extInfo": {
            "sex": 1
        },
        "liveStatus": 2,
        "liveCoverImgUrl": "",
        "liveInfo": {
            "anchorStatusFlag": 2048,
            "switchFlag": 53727,
            "lotterySetting": {
                "settingFlag": 0,
                "attendType": 4
            }
        },
        "status": 0
    }
}

修改于将近 2 年前

发私信图片消息

搜索并关注