# 单个文件上传

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

接口英文名：singleFileUpload

该接口用于上传媒体（和封面）文件，上传小文件（小于10MB）时使用。上传大文件请使用分片上传接口。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/wxa/sec/vod/singlefileupload?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用。

# 第三方调用

本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：153
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String Parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token、authorizer_access_token

# 请求体 `Request Payload`

参数名	类型	必填	示例	说明
media_name	string	是	我的演艺 - 第1集	文件名，需按照“剧目名 - 对应剧集数”格式命名文件
media_type	string	是	MP4	视频格式，支持：MP4，TS，MOV，MXF，MPG，FLV，WMV，AVI，M4V，F4V，MPEG，3GP，ASF，MKV
media_data	buffer	是	-	视频文件内容，二进制。
cover_type	string	否	JPG	视频封面图格式，支持：JPG、JPEG、PNG、BMP、TIFF、AI、CDR、EPS、TIF
cover_data	buffer	否	-	视频封面图文件内容，二进制。
source_context	string	否	-	来源上下文，会在上传完成事件中透传给开发者。

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	示例	说明
errcode	number	-	错误码
errmsg	string	ok	错误信息
media_id	number	-	媒体文件id。

# 4. 注意事项

不填写 cover_type，cover_data 字段时默认截取视频首帧作为封面图。
Content-Type 需要指定为 multipart/form-data; boundary=<delimiter>
<箭头括号> 表示必须替换为有效值的变量。

# 5. 代码示例

请求示例

POST /wxa/sec/vod/singlefileupload?access_token=ACCESS_TOKEN HTTP/1.1
Host: api.weixin.qq.com
Content-Type: multipart/form-data; boundary=--------------------------334603653359572775563544
Content-Length: 1675021

----------------------------334603653359572775563544
Content-Disposition: form-data; name="media_name"

我的演艺 - 第1集
----------------------------334603653359572775563544
Content-Disposition: form-data; name="media_type"

MP4
----------------------------334603653359572775563544
Content-Disposition: form-data; name="cover_type"

JPEG
----------------------------334603653359572775563544
Content-Disposition: form-data; name="media_data"; filename="test.mp4"

<test.mp4>
----------------------------334603653359572775563544
Content-Disposition: form-data; name="cover_data"; filename="wechat.jpeg"

<wechat.jpeg>
----------------------------334603653359572775563544--

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "media_id": 123456
}

# 6. 错误码

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

错误码	错误描述
-2	初始化未完成，请稍后再试
-1	系统错误
43002	HTTP请求必须使用POST方法
44002	POST内容为空
47001	输入格式错误
47003	参数不符合要求
10090001	视频类型不支持
10090002	图片类型不支持
10090003	图片URL无效
10090005	resource_type无效
10090038	被授权账号没有【文娱-微短剧】类目
10090039	已经被解除授权
10090040	剧集已经被占用
10090041	剧目名称不符合规范
10090042	剧集名称不符合规范
10090043	不存在授权关系
10093011	操作失败
10093014	参数错误（包括参数格式、类型等错误）
10093023	操作过于频繁
10093030	资源不存在

# 7. 适用范围

本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请已实际调用情况为准。

# 单个文件上传

# 1. 调用方式

# HTTPS 调用

# 云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# 4. 注意事项

# 5. 代码示例

# 6. 错误码

# 7. 适用范围

# 查询参数 `Query String Parameters`

# 请求体 `Request Payload`

# 返回体 `Response Payload`