cdn下载

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

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

POST

/gehub/v2/api/message/downloadCdn

下载图片失败时，可以试试另外两种图片格式。

注意：不是所有图片都有高清和常规版本。

请求参数

Header 参数

X-GEHUB-TOKEN

string

必需

示例:

Body 参数application/json

appId

string

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

aesKey

string

必需

cdn的aeskey

fileId

string

必需

cdn的fileid

type

string

必需

下载的文件类型 1：高清图片 2：常规图片 3：缩略图 4：视频 5：文件

totalSize

string

文件大小

必需

suffix

string

必需

下载类型为文件时，传文件的后缀（例：doc）

示例

{
    "appId": "{{appid}}",
    "aesKey": "f46be643aa0dc009ae5fb63bbc73335d",
    "totalSize": "63",
    "type": "5",
    "fileId": "3057020100044b304902010002043904752002032f7d6d02046bb5bade02046593760c042433653765306131612d646138622d346662322d383239362d3964343665623766323061370204051400050201000405004c53d900",
    "suffix": "json"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://wxapi.xiaoyu.fan/gehub/v2/api/message/downloadCdn' \
--header 'X-GEHUB-TOKEN: {{gehub-token}}' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "",
    "aesKey": "f46be643aa0dc009ae5fb63bbc73335d",
    "totalSize": "63",
    "type": "5",
    "fileId": "3057020100044b304902010002043904752002032f7d6d02046bb5bade02046593760c042433653765306131612d646138622d346662322d383239362d3964343665623766323061370204051400050201000405004c53d900",
    "suffix": "json"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

ret

integer

必需

msg

string

必需

data

object

必需

fileUrl

string

必需

文件链接地址，7天有效

示例

{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "fileUrl": "http://wxapii.oos-sccd.ctyunapi.cn/20240102/wx_HJDZOY09-ucKMhzu8jQ2Z/f6eee8b1-fd10-451e-a8eb-d64d5eed1274.json?AWSAccessKeyId=9e882e7187c38b431303&Expires=1704768509&Signature=4ZHUE7xfJziBpAcYIsvlKTpWJDI%3D"
    }
}

修改于 12 天前

下载emoji

发送文字消息