通用场景
用于创建支付宝素材
公共请求参数
业务请求参数
out_biz_no｜外部业务单号必选string[1,64]
【描述】外部业务单号，用作幂等控制，相同单号会返回上一次的结果，接入方需保证单号唯一。
【示例值】21ba1e1c16456985463242192e4d
material_spec_id｜素材规范id必选string[1,128]
【描述】素材规范id，用于标识具体场景下的素材规范，根据具体的使用场景获取对应的素材规范id。
【示例值】2019041301000200000077970001
material_name｜素材名称必选string[1,128]
【描述】素材名称，接入方自行生成，建议命名时遵循一定的规律以方便管理。
【示例值】测试素材名称
material_fields｜素材字段列表必选array
【描述】素材字段列表，素材提报的具体内容，包含三种类型：图片、文本、链接。图片类型，则根据“图片资源上传接口”中返回的resource_id字段值进行素材字段的设值。文本或链接类型，则按照实际需要设值即可，需满足具体的规范要求。规范要求详情请参见产品文档。
field_name｜素材字段名称必选string[1,32]
【描述】素材字段名称，来源于素材规范定义的字段名称。注意一次素材提报中字段名称不能重复。
【示例值】servicebigpic
field_value｜素材字段值必选array[1,1000]
【描述】素材字段值，素材字段提报的实际值，支持多值，具体的要求请查看素材规范或对应的产品文档。
【示例值】["a*wxytaswgww"]
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.material.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"out_biz_no":"21ba1e1c16456985463242192e4d",
"material_spec_id":"2019041301000200000077970001",
"material_name":"测试素材名称",
"material_fields":[
{
"field_value":[
"a*wxytaswgww"
],
"field_name":"servicebigpic"
}
]
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
material_id｜素材id必选string(28)
【描述】素材id。
【示例值】2019070100903002019700470001
响应示例
正常示例
异常示例
{
"alipay_marketing_material_create_response": {
"code": "10000",
"msg": "success",
"material_id": "2019070100903002019700470001"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| materialspecid_not_exist | 素材规范id不存在 | 请从素材规范id的来源处确认素材规范id的正确性 |
| materialspec_check_failed | 素材规范检查失败 | 请根据接口返回的错误信息定位问题，并按照素材规范要求修改后重新提报 |
| materialspec_check_failed | 素材规范检查失败 | 请根据接口返回的错误信息定位问题，并按照素材规范要求修改后重新提报 |