创建关联普通二维码模式
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/open/mini/qrcode/pattern/create
错误码
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | INVALID_PARAMETER | 参数有误，输入参数非法 | 检查必填参数是否为空，或者长度是否超限 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或系统异常，导致服务调用失败，可重新发起请求 |
| 400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或系统异常，导致服务调用失败，可重新发起请求 |
| 400 | QRCODE_ROUTE_URL_INVALID | 参数pattern_url格式非法 | 请参考接口文档检查参数是否正确 |
| 400 | TEMPLATE_MISMATCH_ISVAPPID | 模板和三方应用关系不匹配 | 请重新上架基于模板构建的小程序版本, 该模板必须是自己三方应用下持有的模板 |
| 400 | TEMPLATE_NOT_HAVE_HOST | 非模板名下持有域名 | 请到开放平台配置小程序模板普通二维码路由规则(域名必须相同) |
| 400 | QRCODE_ROUTE_CREATE_NEED_VERSION | 请先发布代码后再配置二维码规则 | 确保小程序已经创建过版本 |
| 400 | QRCODE_ROUTE_PATTERN_OVER_LIMIT | 模式超出个数限制 | 删除之前已创建的无用模式 |
| 400 | QRCODE_ROUTE_HOST_VALID_FAILED | 二维码域名校验失败 | 请检查校验文件是否放置在模式域名的根目录 |
| 400 | APP_INFO_NOT_EXIST | 应用信息不存在 | 检查appId是否正确 |
| 400 | 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}之间无冲突 |
| 400 | QRCODE_ROUTE_PATTERN_CONFLICT_OTHER | 与其他小程序的模式发生冲突 | 更换模式，或者联系技术支持人员 |
| 400 | NOT_CURRENTLY_AVALIALBE | 该功能尚未全量开放 | 联系技术人员，是否有资格使用该功能 |
| 400 | SECUTIY_SSRF_URL_FAILD | 网址访问失败 | 请确认网址是否存在 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/mini/qrcode/pattern/create' \
--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 '{
"pattern_url":"http://yoursite.com/merchant/{0}/shop/{1}",
"invoke_type":"ISV",
"template_id":"202100317266XXXX"
}'响应示例响应示例
200 - 成功示例
{
"route_group": "78b59c5b6b2946448bc77e17e544b813"
}请求参数
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