支付宝文件上传接口

支付宝通用文件上传接口，支付宝开发者可以调用此接口上传文件，文件可以提供给其他业务使用，例如：上传素材（视频/图片），素材可以供给到生活号+/小程序等其他开放应用后正式发布。
该接口支持使用支付宝SDK和HTTP POST请求，两种方式示例如下：

使用支付宝SDK时，可以直接使用FileItem上传，代码片段参考下文

使用直接使用http协议时，需要忽略file_content参数，文件放入表单中，其余参数放入URL中，其中将参数（不包括文件和file_content）按自行实现签名文档实现，示例：
curl --request POST 'http://openapi.alipay.com/gateway.do?charset=GBK&biz_content=%7B%22biz_code%22%3A%22content_creation%22%2C%22extra_parameters%22%3A%7B%22extern_upload%22%3A%22youku%22%2C%22alipay_user_id%22%3A%22xxxx%22%7D%7D&method=alipay.open.file.upload&format=json&sign=xxx&app_id=2014060600164699&version=1.0&sign_type=RSA2×tamp=xxx' --form 'file=@"xx.mp4"'

公共错误码

前往查看

业务错误码

状态码	错误码	错误描述	解决方案
400	FILE_CHECK_FAIL	文件MD5值校验失败	确认MD5值是否正确，如果MD5值正确，可重试
400	BIZ_ERROR	业务异常账号未绑定优酷	将支付宝账号绑定优酷服务

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/file/upload' \ --header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \ --header 'alipay-request-id: $requestid' \ --form 'file_content="sample.jpg"' \ --form 'data="{ \"biz_code\":\"content_creation\", \"md5\":\"9cff2d79bc81acf12abbaca7328a4dc5\", \"extra_parameters\":{ \"extern_upload\":\"youku\" } }"' \ --form 'biz_code=""'

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Body 参数multipart/form-data

file_content

string

必需

【描述】文件内容的二进制流
【示例值】-

示例值:

sample.jpg

data

string

可选

【描述】素材使用场景，请关联其他开放平台接口联合使用。如果素材用于内容发布，请必传入content_creation
【示例值】content_creation

示例值:

{ "biz_code":"content_creation", "md5":"9cff2d79bc81acf12abbaca7328a4dc5", "extra_parameters":{ "extern_upload":"youku" } }

biz_code

string

必需

返回响应

🟢200成功

application/json

Body

file_id

string

必需

【描述】文件id，用于提供后后续业务调用使用【示例值】A*6XqwQKpS1t0AAAAAAAAAAAAADi92AA

extern_id

string

可选

【描述】视频资源id，同步外部渠道后，外部渠道返回的id。目前支持同步优酷场景，返回优酷视频id，用于支付宝客户端播放视频使用【示例值】XNTk0NjE5NjI4OA==

🟠400请求有误

支付宝文件上传接口

公共错误码#

业务错误码#

请求参数

返回响应

公共错误码

业务错误码