URL Scheme打開小程序

通過服務(wù)端接口或在小程序管理后臺(tái)「工具」-「生成URL Scheme」入口可以獲取打開小程序任意頁(yè)面的URL Scheme,。適用于從短信、郵件,、微信外網(wǎng)頁(yè)等場(chǎng)景打開小程序,。 通過URL Scheme打開小程序的場(chǎng)景值為 1065。

生成的URL Scheme如下所示：

weixin://dl/business/?t= *TICKET*

iOS系統(tǒng)支持識(shí)別URL Scheme,，可在短信等應(yīng)用場(chǎng)景中直接通過Scheme跳轉(zhuǎn)小程序,。

Android系統(tǒng)不支持直接識(shí)別URL Scheme，用戶無(wú)法通過Scheme正常打開小程序,，開發(fā)者需要使用H5頁(yè)面中轉(zhuǎn),，再跳轉(zhuǎn)到Scheme實(shí)現(xiàn)打開小程序，跳轉(zhuǎn)代碼示例如下：

location.href = 'weixin://dl/business/?t= *TICKET*'

該跳轉(zhuǎn)方法可以在用戶打開H5時(shí)立即調(diào)用,，也可以在用戶觸發(fā)事件后調(diào)用,。

調(diào)用上限

Scheme將根據(jù)是否為到期有效與失效時(shí)間參數(shù)，分為短期有效Scheme與長(zhǎng)期有效Scheme：

單個(gè)小程序每日生成Scheme上限為50萬(wàn)個(gè)（包含短期有效Scheme與長(zhǎng)期有效Scheme）

有效時(shí)間超過31天的Scheme或永久有效的Scheme為長(zhǎng)期有效Scheme,，單個(gè)小程序總共可生成長(zhǎng)期有效Scheme上限為10萬(wàn)個(gè),，請(qǐng)謹(jǐn)慎調(diào)用

有效時(shí)間不超過31天的Scheme為短期有效Scheme，單個(gè)小程序生成短期有效Scheme不設(shè)上限

注意事項(xiàng)

生成的URL Scheme僅支持從微信外打開小程序,。微信內(nèi)的網(wǎng)頁(yè)如需打開小程序請(qǐng)使用微信開放標(biāo)簽-小程序跳轉(zhuǎn)按鈕,，無(wú)公眾號(hào)也可以直接使用小程序身份開發(fā)網(wǎng)頁(yè)并免鑒權(quán)跳轉(zhuǎn)小程序,，見云開發(fā)靜態(tài)網(wǎng)站跳轉(zhuǎn)小程序。符合開放范圍的小程序可以下發(fā)支持打開小程序的短信,。

該功能基本覆蓋當(dāng)前用戶正在使用的微信版本,，開發(fā)者無(wú)需進(jìn)行低版本兼容。

只能生成已發(fā)布的小程序的URL Scheme,。

通過URL Scheme跳轉(zhuǎn)到微信時(shí),，可能會(huì)觸發(fā)系統(tǒng)彈框詢問，若用戶選擇不跳轉(zhuǎn),，則無(wú)法打開小程序,。請(qǐng)開發(fā)者妥善處理用戶選擇不跳轉(zhuǎn)的場(chǎng)景。

開放范圍

針對(duì)國(guó)內(nèi)非個(gè)人主體小程序開放,。

示例

示例使用了云開發(fā)靜態(tài)網(wǎng)站托管搭建網(wǎng)頁(yè),，無(wú)需公眾號(hào)，只需準(zhǔn)備好小程序和開通云開發(fā),。網(wǎng)頁(yè)會(huì)判斷所在的環(huán)境來(lái)覺得采用哪種跳轉(zhuǎn)方式，如檢測(cè)到微信客戶端內(nèi),，則免鑒權(quán)使用開放標(biāo)簽跳轉(zhuǎn),，如檢測(cè)到在外部瀏覽器或 App，則使用 URL Scheme 跳轉(zhuǎn)小程序,。

```

const cloud = require('wx-server-sdk')

cloud.init({

  env: cloud.DYNAMIC_CURRENT_ENV

})

exports.main = async (event, context) => {

  try {

    const result = await cloud.openapi.templateMessage.send({

      touser: cloud.getWXContext().OPENID, // 通過 getWXContext 獲取 OPENID

      page: 'index',

      data: {

        keyword1: {

          value: '339208499'

        },

        keyword2: {

          value: '2015年01月05日 12:30'

        },

        keyword3: {

          value: '騰訊微信總部'

        },

        keyword4: {

          value: '廣州市海珠區(qū)新港中路397號(hào)'

        }

      },

      templateId: 'TEMPLATE_ID',

      formId: 'FORMID',

      emphasisKeyword: 'keyword1.DATA'

    })

    // result 結(jié)構(gòu)

    // { errCode: 0, errMsg: 'openapi.templateMessage.send:ok' }

    return result

  } catch (err) {

    // 錯(cuò)誤處理

    // err.errCode !== 0

    throw err

  }

}

```

urlscheme.generate

`獲取小程序scheme碼,，適用于短信、郵件,、外部網(wǎng)頁(yè)等拉起小程序的業(yè)務(wù)場(chǎng)景,。通過該接口，可以選擇生成到期失效和永久有效的小程序碼,，目前僅針對(duì)國(guó)內(nèi)非個(gè)人主體的小程序開放,，詳見獲取URL scheme碼。

調(diào)用方式：

HTTPS 調(diào)用

云調(diào)用

HTTPS 調(diào)用

請(qǐng)求地址

POST https://api.weixin.qq.com/wxa/generatescheme?access_token=qq10572137

請(qǐng)求參數(shù)

屬性類型默認(rèn)值必填說(shuō)明

access_tokenstring是接口調(diào)用憑證

jump_wxaObject否跳轉(zhuǎn)到的目標(biāo)小程序信息,。

is_expirebooleanfalse否生成的scheme碼類型,，到期失效：true，永久有效：false,。

expire_timenumber否到期失效的scheme碼的失效時(shí)間,，為Unix時(shí)間戳。生成的到期失效scheme碼在該時(shí)間前有效,。最長(zhǎng)有效期為1年,。生成到期失效的scheme時(shí)必填。

jump_wxa 的結(jié)構(gòu)

屬性類型默認(rèn)值必填說(shuō)明

pathstring是通過scheme碼進(jìn)入的小程序頁(yè)面路徑,，必須是已經(jīng)發(fā)布的小程序存在的頁(yè)面,，不可攜帶query,。path為空時(shí)會(huì)跳轉(zhuǎn)小程序主頁(yè)。

querystring是通過scheme碼進(jìn)入小程序時(shí)的query,，最大1024個(gè)字符,，只支持?jǐn)?shù)字，大小寫英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~ 

返回值

openlink

生成的小程序scheme 

示例演示官方：www.jumpwx.com