小程序的上传文件接口的注意要点解析

小程序的上传文件接口用于将本地客户端的文件上传到服务器，具体操作过程如下：

请求方式

上传文件接口的请求方式为POST请求。

请求地址

上传文件接口的地址为 https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE。

其中，ACCESS_TOKEN是调用接口时需要携带的调用凭证， TYPE是上传文件的类型，具体类型包括图片（image）、语音（voice）和视频（video）。

请求参数

请求参数包括上传文件的内容和上传文件的描述信息。

上传文件

上传文件信息由以下两个字段构成：

• filename：文件名（必传）
• content：文件的二进制内容（必传）

示例1：上传图片文件

{
    "filename": "example.jpg",
    "content": "example file content"
}

示例2：上传语音文件

{
    "filename": "example.mp3",
    "content": "example file content"
}

上传文件描述信息

上传文件描述信息主要包括以下几个字段：

• title：文件标题（可选）
• introduction：文件描述信息（可选）

示例1：上传图片文件，并上传文件描述信息

{
    "filename": "example.jpg",
    "content": "example file content",
    "title": "example image title",
    "introduction": "example image introduction"
}

示例2：上传语音文件，并上传文件描述信息

{
    "filename": "example.mp3",
    "content": "example file content",
    "title": "example voice title",
    "introduction": "example voice introduction"
}

响应参数

上传文件接口响应的参数主要包括以下两个字段：

• type：文件类型
• media_id：文件的唯一标识符

注意事项

在使用小程序上传文件接口时，需要注意以下几点：

• 文件类型的大小限制：图片不超过2M，语音和视频不超过5M。
• 文件上传地址只支持HTTPS协议。
• 上传的文件限制是已知的 MIME 类型，即上传的文件类型必须为特定的类型。
• 文件类型的标记和文件数据使用不同的字符集进行编码，使用时要特别注意。

示例代码

示例1：上传图片文件，并上传文件描述信息

let param = {
    filename: "example.jpg",
    content: "example file content",
    title: "example image title",
    introduction: "example image introduction"
};
wx.uploadFile({
    url: 'https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=image',
    filePath: 'file_path',
    name: 'media',
    header: {
        'content-type': 'multipart/form-data'
    },
    formData: param,
    success: function (res) {
        console.log(res);
    },
    fail: function (res) {
        console.log(res);
    }
})

示例2：上传语音文件，并上传文件描述信息

let param = {
    filename: "example.mp3",
    content: "example file content",
    title: "example voice title",
    introduction: "example voice introduction"
};
wx.uploadFile({
    url: 'https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=voice',
    filePath: 'file_path',
    name: 'media',
    header: {
        'content-type': 'multipart/form-data'
    },
    formData: param,
    success: function (res) {
        console.log(res);
    },
    fail: function (res) {
        console.log(res);
    }
})