开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
api 列表
小程序二维码
小程序服务
订单中心
小程序开发管理
生物核身
交易组件
小程序商品
支付有礼
商家粉丝群
营销产品
资金产品
会员产品
信用产品
广告产品
开发 > 服务端 > 私域产品 > 小程序产品 > 权限集列表 > 小程序码 > api 列表 > 创建关联普通二维码模式接口
收藏
订阅更新
我的文档
设置
接入检测
即可查看检测结果)
若有未通过的接入检测项,接口将无法调通
用于商户或者服务商创建关联普通二维码模式,此模式可以用于创建,适用于同一个host下面存在大量路由的场景,可以提升路由性能。一个小程序或者三方应用下最多可创建20个模式。

公共请求参数

参数类型是否必选最大长度描述示例值
app_idstring必选32
支付宝分配给开发者的应用id
2014072300007148
methodstring必选128
接口名称
alipay.open.mini.qrcode.pattern.create
formatstring可选40
仅支持json
json
charsetstring必选10
请求使用的编码格式,如utf-8,gbk,gb2312等
utf-8
sign_typestring必选10
商户生成签名字符串所使用的签名算法类型,目前支持rsa2和rsa,推荐使用rsa2
rsa2
signstring必选344
商户请求参数的签名串,详见签名
详见示例
timestampstring必选19
发送请求的时间,格式"yyyy-mm-dd hh:mm:ss"
2014-07-24 03:07:50
versionstring必选3
调用的接口版本,固定为:1.0
1.0
app_auth_tokenstring可选40
biz_contentstring必选
请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

业务请求参数

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"
}' 
说明:本示例仅供参考。

公共响应参数

参数类型是否必选最大长度描述示例值
codestring必选-
网关返回码,
40004
msgstring必选-
网关返回码描述,
business failed
sub_codestring可选-
业务返回码,参见具体的api接口文档
acq.trade_has_success
sub_msgstring可选-
业务返回码描述,参见具体的api接口文档
交易已被支付
signstring必选-
签名,
dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

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非模板名下持有域名
请到开放平台配置小程序模板普通二维码路由规则(域名必须相同)
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
为开发者能享受更简单的协议处理逻辑、更丰富的开源工具配套、更低的接口响应时延,支付宝开放平台推出符合oas3.0规范的,助力开发体验。新版本文档请点击“查看v3版本”进行访问。
网站地图