通用场景
用于商户或者服务商创建关联普通二维码模式,此模式可以用于创建,适用于同一个host下面存在大量路由的场景,可以提升路由性能。一个小程序或者三方应用下最多可创建20个模式。
公共请求参数
业务请求参数
pattern_url|模式必选string[1,256]
【描述】模式,用于描述通用的路由url格式,适用于同一个host下面存在大量路由的场景,主要用于提升路由性能,其中{0}、{1} 代表路径中的变量
【示例值】http://yoursite.com/merchant/{0}/shop/{1}
invoke_type|调用类型必选string[1,16]
【描述】调用类型,目前支持三种调用类型:delegate、merchant和isv,不同调用类型会导致模式归属者不同
【枚举值】
表示服务商代商家创建模式,此时模式会属于商家小程序: delegate
服务商使用三方应用自调用创建模式,此时模式会属于三方应用: isv
商家自调用创建模式,此时模式会属于商家小程序: merchant
【示例值】isv
template_id|模板小程序id可选string[1,32]
【描述】模板小程序id。当invoke_type为delegate或者isv时,需要指定模板小程序的id,用于校验模式的host是否存在于该模板小程序普通链接二维码的已验证列表中;当invoke_type为merchant时,需要确保模式host所在的域名服务器根目录下放置了校验文件
【示例值】202100317266xxxx
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.qrcode.pattern.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"pattern_url":"http://yoursite.com/merchant/{0}/shop/{1}",
"template_id":"202100317266xxxx",
"invoke_type":"isv"
}'
说明:本示例仅供参考。
公共响应参数
业务响应参数
route_group|路由规则组必选string(64)
【描述】路由规则组,用于唯一标记所创建模式的字段
【示例值】78b59c5b6b2946448bc77e17e544b813
响应示例
正常示例
异常示例
{
"alipay_open_mini_qrcode_pattern_create_response": {
"code": "10000",
"msg": "success",
"route_group": "78b59c5b6b2946448bc77e17e544b813"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息,修改参数后进行重试 |
app_info_not_exist | 应用信息不存在 | 检查appid是否正确 |
not_currently_avalialbe | 该功能尚未全量开放 | 联系技术人员,是否有资格使用该功能 |
qrcode_route_create_need_version | 请先发布代码后再配置二维码规则 | 确保小程序已经创建过版本 |
qrcode_route_host_valid_failed | 二维码域名校验失败 | 请检查校验文件是否放置在模式域名的根目录 |
qrcode_route_pattern_conflict | 与名下已有模式发生冲突 | 检查名下其他的模式,确保两个模式的路径中存在非占位符的不同元素。如http://yoursite.com/merchant/{0} 与 http://yoursite.com/{0} /merchant、http://yoursite.com/{0} /{1}、http://yoursite.com/{0} /{1}/{2} 均存在冲突,与http://yoursite.com/isv/{0}之间无冲突 |
qrcode_route_pattern_conflict_other | 与其他小程序的模式发生冲突 | 更换模式,或者联系凯发app官方网站的技术支持人员 |
qrcode_route_pattern_over_limit | 模式超出个数限制 | 删除之前已创建的无用模式 |
qrcode_route_url_invalid | 参数pattern_url格式非法 | 请参考接口文档检查参数是否正确 |
secutiy_ssrf_url_faild | 网址访问失败 | 请确认网址是否存在 |
template_mismatch_isvappid | 模板和三方应用关系不匹配 | 请重新上架基于模板构建的小程序版本, 该模板必须是自己三方应用下持有的模板 |
template_not_have_host | 非模板名下持有域名 | 请到开放平台配置小程序模板普通二维码路由规则(域名必须相同) |