微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 获取文件下载链接

    调试诊断

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

    接口英文名：getdownloadurl

    通过该接口可获取文件下载链接，使用链接可下载到文件的内容。

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/channels/ec/open/get_download_url?access_token=ACCESS_TOKEN

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用）

    # 请求体 Request Payload

    参数名类型必填说明
    openidstring是下单用户openid
    order_idstring是用户下单的订单号

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型示例说明
    errcodenumber0错误码，0-成功,其他-失败
    errmsgstringok错误信息
    expire_timenumber链接到期时间(秒)，有效期10分钟
    urlstring文件下载链接

    # 4. 注意事项

    1. 该接口访问频率限制：order_id维度-10次/天
    2. 当订单已结算或超过售后期7天后，不可获取对应的文件下载链接

    # 5. 代码示例

    请求示例

    {
  "openid":"23982ADD2323",
  "order_id":"239829312"
}

    返回示例

    {
  "errcode":0,
  "errmsg":"成功",
  "url":"https://cos.tencent.com/image/test.png",
  "expire_time":17823232312
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

    错误码错误描述
    -1系统失败，请重试
    0成功
    10001无效的mediaid
    10002无效的mediaid
    10003文件正在上传中，请等待
    10004上传文件存在风险，请重新上传
    10005订单已取消，禁止下载文件
    10006订单已结束，禁止下载文件
    10007上传文件格式不支持
    10008上传文件的大小超过最大值
    10009下载文件次数超过日上限，请第二天再试
    10010上传url(file_url)无效，无法下载文件

    # 7. 适用范围

    本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。

    接口变更日志（1条）
    2025 年 11 月 20 日
    download_url 字段修正为 url 字段