卡券模板更新接口
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/pass/template/update
错误码
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | KP.AE_SYSTEM_ERROR | 系统繁忙或系统异常 | 尝试重试 |
| 400 | KP.AE_ALIPASS_TEMPLATE_PARAMTER_IS_NULL | 模板参数为空 | 确认请求中的模板参数是否为空 |
| 400 | KP.AE_ALIPASS_TEMPLATE_APP_ID_IS_NULL | 入参app_id为空 | 确认参数app_id是否填入 |
| 400 | KP.AE_ALIPASS_TEMPLATE_CONTENT_IS_BLANK | 入参tpl_content为空 | 确认参数tpl_content是否填入 |
| 400 | KP.AE_ALIPASS_TEMPLATE_UNIQUE_ID_IS_BLANK | 入参unique_id为空 | 确认参数unique_id是否填入 |
| 400 | KP.AE_ALIPASS_RECOGNITION_TYPE_NOSUPPORT | 发券方式不支持 | 确认appId已填入的前提下，尝试重试 |
| 400 | KP.AE_ALIPASS_TEMPLATE_CONTENT_FORMAT_ERR | 入参tpl_content格式错误 | 确认参数tpl_content格式是否正确 |
| 400 | KP.AE_ALIPASS_TEMPLATE_NOT_EXIST | 目标模板信息不存在 | 确认tpl_id传入值为预期的模板编号 |
| 400 | KP.AE_ILLEGAL_PARAMETERS | 保存模板信息时存在参数错误 | 确认参数是否符合文档预期，尝试重试 |
| 400 | KP.AE_ALIPASS_DATA_CONTAIN_FORBIDDEN_WORD | 模板内容中存在敏感词、违禁词 | 去除模板内容中的敏感词、违禁词 |
| 400 | KP.AE_ALIPASS_TEMPLATE_UNRECOGNIZE_PROPERTY | 模板内容tpl_content中存在不识别的属性 | 核查确认入参tpl_content中的字段属性符合文档预期 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/pass/template/update' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
"tpl_id":"f038871a4b1151e8038bb9277c3d52e3",
"tpl_content":"{\"logo\": \"\",\"strip\": null,\"icon\": null,\"content\": {}}"
}'响应示例响应示例
{
"success": "true",
"result": "{\"errorCode\":\"KP.AE_SUCCESS\",\"errorMsg\":\"处理成功\",\"tpl_id\":\"2017032xxxxxxxx\",\"tpl_params\":[\"title\",\"channelID\",\"serialNumer\"]}"
}请求参数
Header 参数
authorization
string
必需
示例值:
ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign
alipay-request-id
string
必需
示例值:
$requestid
Content-Type
string
必需
示例值:
application/json
Body 参数application/json