营销图片资源上传接口

营销通用上传图片接口

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
app_id	String	必选	32	支付宝分配给开发者的应用ID	2014072300007148
method	String	必选	128	接口名称	alipay.marketing.material.image.upload
format	String	可选	40	仅支持JSON	JSON
charset	String	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	String	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2	RSA2
sign	String	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	String	必选	19	发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"	2014-07-24 03:07:50
version	String	必选	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	String	可选	40	详见应用授权概述

请求参数

参数中文名	参数英文名	类型	是否必选	最大长度	描述	示例值
图片内容	file_content	byte[]	必选	2097152	图片的byte字节数组。图片大小限制为2M	-
文件业务标识	file_key	String	特殊可选	32	文件业务标识。 alipay.marketing.activity.delivery.create接口中 delivery_base_info.delivery_material.delivery_single_material.delivery_image 当delivery_booth_code=PUBLIC_UNION，上传图片接口需指定file_key=PUBLIC_UNION_CHANNEL_PIC；当delivery_booth_code=PAYMENT_RESULT，上传图片接口需指定file_key=DELIVERY_CHANNEL_PIC。上传图片更多要求参考文档： https://render.alipay.com/p/c/18tpirlg12e8?operateFrom=BALIPAY alipay.marketing.activity.ordervoucher.create接口中 voucher_display_pattern_info.brand_logo字段,file_key=PROMO_BRAND_LOGO，voucher_display_pattern_info.voucher_image 字段,file_key=PROMO_VOUCHER_IMAGE	PROMO_VOUCHER_IMAGE
商户接入模式	merchant_access_mode	String	必选	32	商户接入模式枚举值 SELF_MODE 商户自接入模式 AGENCY_MODE 服务商代接入模式枚举值商户自接入模式: SELF_MODE服务商代接入模式: AGENCY_MODE	SELF_MODE

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	String	必选	-	网关返回码,详见文档	40004
msg	String	必选	-	网关返回码描述,详见文档	Business Failed
sub_code	String	可选	-	业务返回码，参见具体的API接口文档	ACQ.TRADE_HAS_SUCCESS
sub_msg	String	可选	-	业务返回码描述，参见具体的API接口文档	交易已被支付
sign	String	必选	-	签名,详见文档	DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

响应参数

参数中文名	参数英文名	类型	是否必选	最大长度	描述	示例值
图片唯一资源ID	resource_id	String	必选	64	图片唯一资源ID	adeDSktiQO-u5vJUqVbcQwAAACMAAQED
是否优化过	resource_enhance	Boolean	特殊可选	16	图片是否优化过。系统会根据要求，对上传的图片做尺寸的优化。	false
图片的url地址	resource_url	String	特殊可选	128	上传后图片的url地址	https://mdn.alipayobjects.com/afts/img/A*o-BSQa2Pnq4mIFdCjUnmqAAAARwnAQ/original?bz=promo_merchant

请求示例

Java

PHP

HTTP

响应示例

json

xml

{
    "alipay_marketing_material_image_upload_response": {
        "code": "10000",
        "msg": "Success",
        "resource_id": "adeDSktiQO-u5vJUqVbcQwAAACMAAQED",
        "resource_enhance": false,
        "resource_url": "https://mdn.alipayobjects.com/afts/img/A*o-BSQa2Pnq4mIFdCjUnmqAAAARwnAQ/original?bz=promo_merchant"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

**说明：**本示例仅供参考。

异常示例

json

{
    "alipay_marketing_material_image_upload_response": {
        "code": "20000",
        "msg": "Service Currently Unavailable",
        "sub_code": "isp.unknow-error",
        "sub_msg": "系统繁忙"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

错误码

公共错误码

前往查看

业务错误码

错误码	错误描述	解决方案
SYSTEM_ERROR	系统繁忙,文件上传失败	可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
INVALID_PARAMETER	参数有误请求参数异常	请求参数异常，请根据具体返回的错误信息排查后，重新设置入参
FILE_SIZE_OUT_OF_RANGE	文件大小超过限制	请使用图片文件上传接口重新上传图片，大小不能超过2M
FILE_TYPE_ERROR	文件格式不正确，不是图片文件格式	请使用图片上传接口上传图片类型的文件，不支持其他文件类型
MATERIAL_ERROR	文件格式不正确	请详细阅读相关接口字段描述，上传正确的文件。请检查文件大小是否满足需求，图片宽度和高度是否满足需求，图片是否清晰，图片是否存在违规内容。
PIC_SUFFIX_ILLEGAL	文件后缀名称不合法	仅支持文件后缀名称为bmp, png, jpg, jpeg, gif的图片文件，请重新上传

营销图片资源上传接口

公共请求参数#

请求参数#

公共响应参数#

响应参数#

请求示例#

响应示例#

异常示例#

错误码#

公共错误码#

业务错误码#

公共请求参数

请求参数

公共响应参数

响应参数

请求示例

响应示例

异常示例

错误码

公共错误码

业务错误码