转发图片

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

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

POST

/gehub/v2/api/message/forwardImage

先通过发送图片消息获取CDN信息，再用这些信息（aeskey、cdnthumbaeskey、cdnthumburl、cdnmidimgurl、length、md5等）替换XML中的对应参数，即可直接转发该图片。

请求参数

Header 参数

X-GEHUB-TOKEN

string

必需

示例:

Idempotency-Keystring必需

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

Body 参数application/json

appId

string

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

toWxid

string

好友/群的ID

必需

xml

string

文件消息的xml

必需

示例

{
    "appId": "{{appid}}",
    "toWxid": "34757816141@chatroom",
    "xml": "<?xml version=\"1.0\"?>\n<msg>\n\t<img aeskey=\"294774c8ac2ca8f8114e4d58d2ba78a5\" encryver=\"1\" cdnthumbaeskey=\"294774c8ac2ca8f8114e4d58d2ba78a5\" cdnthumburl=\"3057020100044b304902010002043904752002032f7d6d02046bb5bade020465937656042436626431373937632d613430642d346137662d626230352d3832613335353935333130630204051818020201000405004c543d00\" cdnthumblength=\"2253\" cdnthumbheight=\"120\" cdnthumbwidth=\"111\" cdnmidheight=\"0\" cdnmidwidth=\"0\" cdnhdheight=\"0\" cdnhdwidth=\"0\" cdnmidimgurl=\"3057020100044b304902010002043904752002032f7d6d02046bb5bade020465937656042436626431373937632d613430642d346137662d626230352d3832613335353935333130630204051818020201000405004c543d00\" length=\"4061\" md5=\"799ee4beed51720525232aef6a0d2ec4\" />\n\t<platform_signature></platform_signature>\n\t<imgdatahash></imgdatahash>\n</msg>"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://wxapi.xiaoyu.fan/gehub/v2/api/message/forwardImage' \
--header 'X-GEHUB-TOKEN: {{gehub-token}}' \
--header 'Idempotency-Key: {{idempotency-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "",
    "toWxid": "34757816141@chatroom",
    "xml": "<?xml version=\"1.0\"?>\n<msg>\n\t<img aeskey=\"294774c8ac2ca8f8114e4d58d2ba78a5\" encryver=\"1\" cdnthumbaeskey=\"294774c8ac2ca8f8114e4d58d2ba78a5\" cdnthumburl=\"3057020100044b304902010002043904752002032f7d6d02046bb5bade020465937656042436626431373937632d613430642d346137662d626230352d3832613335353935333130630204051818020201000405004c543d00\" cdnthumblength=\"2253\" cdnthumbheight=\"120\" cdnthumbwidth=\"111\" cdnmidheight=\"0\" cdnmidwidth=\"0\" cdnhdheight=\"0\" cdnhdwidth=\"0\" cdnmidimgurl=\"3057020100044b304902010002043904752002032f7d6d02046bb5bade020465937656042436626431373937632d613430642d346137662d626230352d3832613335353935333130630204051818020201000405004c543d00\" length=\"4061\" md5=\"799ee4beed51720525232aef6a0d2ec4\" />\n\t<platform_signature></platform_signature>\n\t<imgdatahash></imgdatahash>\n</msg>"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

ret

integer

必需

msg

string

必需

data

object

必需

toWxid

string

接收人的wxid

必需

createTime

integer

发送时间

必需

msgId

integer

消息ID

必需

newMsgId

integer

消息ID

必需

type

null

消息类型

必需

aesKey

string

必需

cdn相关的aeskey

fileId

string

必需

cdn相关的fileid

length

integer

图片文件大小

必需

width

integer

图片宽度

必需

height

integer

图片高度

必需

md5

string

图片md5

必需

示例

{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "toWxid": "34757816141@chatroom",
        "createTime": 0,
        "msgId": 769533749,
        "newMsgId": 7003061792458480517,
        "type": null,
        "aesKey": "294774c8ac2ca8f8114e4d58d2ba78a5",
        "fileId": "3057020100044b304902010002043904752002032f7d6d02046bb5bade020465937656042436626431373937632d613430642d346137662d626230352d3832613335353935333130630204051818020201000405004c543d00",
        "length": null,
        "width": null,
        "height": null,
        "md5": null
    }
}

修改于 12 天前

转发文件

转发视频