小程序
取消
开发
中文
EN
取消
  • 服务端

    • # 获取 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万
    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 自定义编译条件