# 获取 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 | 否 | 跳转到的目标小程序信息。 |
| | 属性 | 类型 | 必填 | 说明 |
|---|
| path | string | 否 | 通过 scheme 码进入的小程序页面路径，必须是已经发布的小程序存在的页面，不可携带 query。path 为空时会跳转小程序主页 | | query | string | 否 | 通过 scheme 码进入小程序时的 query，最大1024个字符，只支持数字，大小写英文以及部分特殊字符：`!#$&'()*+,/:;=?@-._~%`` | | env_version | string | 否 | 要打开的小程序版本。正式版为"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万 |
| 9800003 | model_id检查不通过 | |
| 9800007 | 此model_id尚未获得该能力，请能力申请通过后再试 | |
| 9800008 | 能力类型为一机一码，sn不能为空 | |
| 9800009 | 能力类型为一型一码，sn需为空 | |