获取 NFC 的小程序 scheme
获取 NFC 的小程序 scheme
接口应在服务器端调用,详细说明参见服务端API。
接口说明
接口英文名
generateNFCScheme
功能描述
该接口用于获取用于 NFC 的小程序 scheme 码,适用于 NFC 拉起小程序的业务场景。目前仅针对国内非个人主体的小程序开放,详见 NFC 标签打开小程序。
调用方式
HTTPS 调用
POST https://api.weixin.qq.com/wxa/generatenfcscheme?access_token=ACCESS_TOKEN
请求参数
属性 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用getAccessToken | |
jump_wxa | object | 否 | 跳转到的目标小程序信息。 | |
属性类型必填说明pathstring否通过 scheme 码进入的小程序页面路径,必须是已经发布的小程序存在的页面,不可携带 query。path 为空时会跳转小程序主页querystring否通过 scheme 码进入小程序时的 query,最大1024个字符,只支持数字,大小写英文以及部分特殊字符:`!#$&'()*+,/:;=?@-._~%``env_versionstring否要打开的小程序版本。正式版为"release",体验版为"trial",开发版为"develop",仅在微信外打开时生效 | ||||
model_id | string | 是 | scheme对应的设备model_id | |
sn | string | 否 | scheme对应的设备sn,仅一机一码时填写 |
返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
openlink | string | 生成的小程序 scheme 码 |
调用示例
示例说明: HTTPS请求
请求数据示例
{
"jump_wxa":
{
"path": "/pages/publishHomework/publishHomework",
"query": ""
},
"sn": "xxx",
"model_id": "xxx"
}
返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"openlink": Scheme,
}
错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
40002 | 暂无生成权限(非个人主体小程序无权限,未申请 NFC 能力的小程序无权限) | |
40013 | 生成权限被封禁 | |
85079 | miniprogram has no online release | 小程序没有线上版本,即小程序尚未发布,不可进行该操作 |
40165 | invalid weapp pagepath | 参数path填写错误,更正后重试 |
40212 | invalid query | 参数query填写错误 ,query格式遵循URL标准,即k1=v1&k2=v2 |
85402 | invalid env_version | 参数env_version填写错误,更正后重试 |
44990 | reach max api second frequence limit | 频率过快,超过100次/秒;降低调用频率 |
44993 | reach max api day frequence limit | 单天生成Scheme+URL Link数量超过上限50万 |
85400 | reach max long time quota limit | 长期有效Scheme或short link达到生成上限10万,不可再生成。 |
9800003 | model_id检查不通过 | |
9800007 | 此model_id尚未获得该能力,请能力申请通过后再试 | |
9800008 | 能力类型为一机一码,sn不能为空 | |
9800009 | 能力类型为一型一码,sn需为空 |
调试
通过开发者工具的”快速 URL Schema编译“可以调试生成的 URL Schema