# 增加或修改二维码规则
通过本接口可以增加或修改普通链接二维码规则.使用过程中如遇到问题,可在开放平台服务商专区发帖交流。
# 请求地址
POST https://api.weixin.qq.com/cgi-bin/wxopen/qrcodejumpadd?access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | String | 是 | 第三方平台接口调用令牌authorizer_access_token |
| prefix | String | 是 | 二维码规则 |
| permit_sub_rule | Number | 是 | 是否独占符合二维码前缀匹配规则的所有子规 1 为不占用,2 为占用; 详见 |
| path | String | 是 | 小程序功能页面 |
| open_version | Number | 是 | 测试范围 |
| debug_url | String Array | 否 | 测试链接,至多 5 个用于测试的二维码完整链接,此链接必须符合已填写的二维码规则。 |
| is_edit | UInt | 是 | 编辑标志位,0 表示新增二维码规则,1 表示修改已有二维码规则 |
# 测试范围说明
| 取值 | 说明 |
|---|---|
| 1 | 开发版(配置只对开发者生效) |
| 2 | 体验版(配置对管理员、体验者生效) |
| 3 | 正式版(配置对开发者、管理员和体验者生效) |
注意:
- 不管普通二维码规则是否发布,开发者/体验者/管理员在扫描 debug_url 所对应的二维码时,都会根据 open_version 来决定打开开发版、体验版或正式版
POST 数据示例:
{
"prefix": "https://weixin.qq.com/qrcodejump",
"permit_sub_rule": 1,
"path": "pages/index/index",
"open_version": 1,
"debug_url": [
"https://weixin.qq.com/qrcodejump?a=1",
"https://weixin.qq.com/qrcodejump?a=2"
],
"is_edit": 0
}
# 返回参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | UInt | 返回码 |
| errmsg | String | 错误信息 |
返回结果示例:
{
"errcode": 0,
"errmsg": "ok"
}
# 返回码说明
| 返回码 | 说明 |
|---|---|
| 0 | 正常 |
| -1 | 系统繁忙 |
| 44990 | 接口请求太快(超过5次/秒) |
| 85066 | 链接错误 |
| 85068 | 测试链接不是子链接 |
| 85069 | 校验文件失败 |
| 85070 | URL命中黑名单,无法添加 |
| 85071 | 已添加该链接,请勿重复添加 |
| 85072 | 该链接已被占用 |
| 85073 | 二维码规则已满 |
| 85075 | 个人类型小程序无法设置二维码规则 |
| 其他错误码 | 请查看全局错误码 |