发送图片朋友圈

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

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

POST

/gehub/v2/api/sns/sendImgSns

新设备登录后1-3天内，无法使用朋友圈发布、点赞、评论功能。在此期间操作会收到微信团队提醒，请遵守平台规则。

本接口的 imgInfos 参数，需要通过上传朋友圈图片接口获取。

请求参数

Header 参数

X-GEHUB-TOKEN

string

必需

示例:

Idempotency-Keystring必需

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

Body 参数application/json

appId

string

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

allowWxIds

array[string]

允许谁看

可选

atWxIds

array[string]

提醒谁看

可选

disableWxIds

array[string]

不给谁看

可选

privacy

boolean

是否私密

可选

默认值:

false

content

string

朋友圈文字内容

可选

imgInfos

array [object]

必需

通过上传朋友圈图片接口获取

>= 1 items<= 9 items

fileUrl

string

必需

thumbUrl

string

必需

fileMd5

string

必需

length

number

可选

width

number

图片宽度

必需

height

number

图片高度

必需

allowTagIds

array[string]

可选

允许谁看（标签id）

disableTagIds

array[string]

可选

不给谁看（标签id）

示例

{
    "appId": "{{appid}}",
    "allowWxIds": [],
    "atWxIds": [],
    "disableWxIds": [],
    "content": "img",
    "imgInfos": [
        {
            "fileUrl": "http://szmmsns.qpic.cn/mmsns/FzeKA69P5uJr4JZ7M7h6bAeMo2q3AKbyA2aqtKtBTibicSJdhlBuc30AMOCFkCYdnCxleUX35NBBE/0",
            "thumbUrl": "http://szmmsns.qpic.cn/mmsns/FzeKA69P5uJr4JZ7M7h6bAeMo2q3AKbyA2aqtKtBTibicSJdhlBuc30AMOCFkCYdnCxleUX35NBBE/150",
            "fileMd5": "704de7ebbc107a51a4f0986253a6d3b6",
            "length": 1096,
            "width":1920,
            "height":1080
        },
        {
            "fileUrl": "http://szmmsns.qpic.cn/mmsns/FzeKA69P5uJr4JZ7M7h6bAeMo2q3AKby5mg2I3C20yLn95mWHQ0dC4hqWosWyf1zf43Xmut3CCE/0",
            "thumbUrl": "http://szmmsns.qpic.cn/mmsns/FzeKA69P5uJr4JZ7M7h6bAeMo2q3AKby5mg2I3C20yLn95mWHQ0dC4hqWosWyf1zf43Xmut3CCE/150",
            "fileMd5": "f34ccc016a83c23d11b94f9c4ef533f3",
            "length": 1086,
            "width":1920,
            "height":1080
        }
    ],
    "privacy": false,
    "allowTagIds": [],
    "disableTagIds": []
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://wxapi.xiaoyu.fan/gehub/v2/api/sns/sendImgSns' \
--header 'X-GEHUB-TOKEN: {{gehub-token}}' \
--header 'Idempotency-Key: {{idempotency-key}}' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "",
    "allowWxIds": [],
    "atWxIds": [],
    "disableWxIds": [],
    "content": "img",
    "imgInfos": [
        {
            "fileUrl": "http://szmmsns.qpic.cn/mmsns/FzeKA69P5uJr4JZ7M7h6bAeMo2q3AKbyA2aqtKtBTibicSJdhlBuc30AMOCFkCYdnCxleUX35NBBE/0",
            "thumbUrl": "http://szmmsns.qpic.cn/mmsns/FzeKA69P5uJr4JZ7M7h6bAeMo2q3AKbyA2aqtKtBTibicSJdhlBuc30AMOCFkCYdnCxleUX35NBBE/150",
            "fileMd5": "704de7ebbc107a51a4f0986253a6d3b6",
            "length": 1096,
            "width":1920,
            "height":1080
        },
        {
            "fileUrl": "http://szmmsns.qpic.cn/mmsns/FzeKA69P5uJr4JZ7M7h6bAeMo2q3AKby5mg2I3C20yLn95mWHQ0dC4hqWosWyf1zf43Xmut3CCE/0",
            "thumbUrl": "http://szmmsns.qpic.cn/mmsns/FzeKA69P5uJr4JZ7M7h6bAeMo2q3AKby5mg2I3C20yLn95mWHQ0dC4hqWosWyf1zf43Xmut3CCE/150",
            "fileMd5": "f34ccc016a83c23d11b94f9c4ef533f3",
            "length": 1086,
            "width":1920,
            "height":1080
        }
    ],
    "privacy": false,
    "allowTagIds": [],
    "disableTagIds": []
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

ret

integer

必需

msg

string

必需

data

object

必需

integer

朋友圈ID

必需

userName

string

必需

朋友圈作者的wxid

nickName

string

朋友圈作者的昵称

必需

createTime

integer

发布时间

必需

示例

{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "id": 14292802719912825364,
        "userName": "zhangchuan2288",
        "nickName": "朝夕。",
        "createTime": 1703834858
    }
}

修改于 12 天前

发送文字朋友圈

发送视频朋友圈