营销图片资源上传接口 -凯发app官方网站

产品地图

支付产品

私域产品

公域产品

营销产品

商家券 2.0

商家会员卡

红包

棋盘密云

支付券

产品介绍

接入指南

api 列表

支付券

营销图片资源上传接口

私域营销

蚂蚁门店管理

芝麻实力标

资金产品

会员产品

信用产品

安全产品

广告产品

支持第三方代理调用

更新时间：2024-02-22 11:05:58

订阅更新

我的文档

设置

接入检测（

即可查看检测结果）

若有未通过的接入检测项，接口将无法调通

商家券

营销通用上传图片接口

公共请求参数

参数	类型	是否必选	最大长度	描述	示例值
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

【示例值】-

merchant_access_mode｜商户接入模式必选string(32)

【描述】商户接入模式
枚举值
self_mode 商户自接入模式
agency_mode 服务商代接入模式

【枚举值】

商户自接入模式: self_mode

服务商代接入模式: agency_mode

【注意事项】选择服务商代接入模式需配合 app_auth_token 代调用使用

【示例值】self_mode

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

参数中文名	参数英文名	类型	是否必选	最大长度	描述	示例值
图片内容	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 注意事项选择服务商代接入模式需配合 app_auth_token 代调用使用	self_mode

常见请求示例

默认示例

curljavac#php

curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.material.image.upload&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
 -f 'file_content=@/home/admin/test.jpg' \
 -f 'file_key=promo_voucher_image' \
 -f 'belong_merchant_info={
	"merchant_id_type":"smid",
	"business_type":"isv_for_merchant",
	"merchant_id":"2088202967380463"
}' \
 -f 'merchant_access_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=

业务响应参数

resource_id｜图片唯一资源id必选string(64)

【描述】图片唯一资源id

【示例值】adedsktiqo-u5vjuqvbcqwaaacmaaqed

resource_enhance｜是否优化过特殊可选boolean(16)

【描述】图片是否优化过。系统会根据要求，对上传的图片做尺寸的优化。

【示例值】false

resource_url｜图片的url地址特殊可选string(128)

【描述】上传后图片的url地址

【示例值】https://mdn.alipayobjects.com/afts/img/a*o-bsqa2pnq4mifdcjunmqaaaarwnaq/original?bz=promo_merchant

参数中文名	参数英文名	类型	是否必选	最大长度	描述	示例值
图片唯一资源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

响应示例

正常示例

异常示例

{
    "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"
}