Mini Program
取消
Development
中文
EN
取消
  • Guide

    • # Get URL Scheme

    As of 19 December 2023, the URL Scheme has been upgraded. Detailed adjustments can be found in the [URL Scheme and URL Link Optimization Notice]]](https://developers.weixin.qq.com/community/develop/doc/00024e32cbc36055c0c0a34b066401) .An overview of the change points is as follows:

    1. Supports developers to splice parameters after the original encryption URL Scheme;

    2. New plaintext URL Scheme, developers can generate plaintext Scheme without calling interface;

    3. URL Scheme can be accessed by multiple users .

    4. The total number of URL Scheme and URLink openings per [[TIS-0]] per day is capped at 3 million .

    # Encryption URL Scheme

    # How to obtain it

    The server interface can get the encryption URL Scheme to open any Weixin Mini Program page. Suitable for SMS, mail, WeChat outside the web page and other scenarios open Mini programs. The scenario value of opening Weixin Mini Program through URL Scheme is 1065.
    The generated URL Scheme looks like this:

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

    The iOS system supports recognition of URL Scheme, and can jump Weixin Mini Program directly through Scheme in application scenarios such as SMS.
    The Android system does not support the direct identification of URL Scheme, and users cannot normally open Weixin Mini Program through the Scheme. Developers need to use the H5 page to navigate and then jump to the Scheme to enable the opening of the Mini Program. The jump code is as follows:

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

    This jump method can be called immediately when the user opens H5, or after the user triggers an event.

    # Splice parameters

    The original URL Scheme is smoothly upgraded to an encrypted URL Scheme, supporting developers to splice parametersCUSTOM PARAMETEbehind links,The URLScheme after splicing parameters looks like this:

    weixin://dl/business/?t= *TICKET*&cq=*CUSTOM PARAMETER*

    NOTE:

    1. CUSTOM PARAMETEis a specialquery,Max 256 characters, only supports numeric, upper and lower case English and some special characters:! #$&'()*+,/:;=?@ -._~% ', requires url_encode;
    2. The URL Scheme that has been generated before this rule adjustment takes effect can continue to be used normally, and can be directly usedCUSTOM PARAMETEParameter splice;
    3. Encryption after splicing parameters URL Scheme Open Weixin Mini Program The scenario value remains unchanged, at 1065.

    # Plaintext URL Scheme

    # How to obtain it

    Developers do not need to call the platform interface, in the " MP platform - lower left hand side account- Account Settings - Basic Settings - Privacy & Security - Plain Text SchemeUpon this Weixin Mini Program" declaration, you can splice parameters such as AppID and path in the following format as plain text URL Scheme links.

    weixin://dl/business/?appid=*APPID*&path=*PATH*&query=*QUERY*&env_version=*ENV_VERSION*

    The various parameters are defined as follows:

    1. [Required] APPID: Open AppID of Weixin Mini Program via a plaintext URL Scheme;
    2. [Required] PATH: Open the page path of Weixin Mini Program through plaintext URL Scheme, which must be the page that has been published, and cannot carry query;
    3. [Optional]: Open Weixin Mini Program query by [URL Scheme, maximum 512 characters, only support numbers, upper and lower case English and some special characters:!#$&'()*+,/:;=?@ -._~% ', requires url_encode;
    4. [Optional] ENV_VERSION: The Weixin Mini Program version to open, the official version isrelease, the experience version is [[ TAG-1-START]] trial, the development versiondevelop`, effective only when WeChat is opened outside. Note: If you do not fill in, the official Mini Program opens by default.

    The scenario value for opening Weixin Mini Program with a plaintext URL Scheme is 1286.

    # Frequency Limit

    Generation end: The total number of URL Scheme and URLLink generated per day is capped at 500 thousand;

    Open end: The total number of Weixin Mini Program open through URL Scheme (encryption + plaintext) and URLLLink is limited to 3 million per day.

    # Note

    1. WeChat If you want to open Weixin Mini Program, please use WeChat open tab - Mini Program jump button without Official Account can also develop web pages directly using Mini Program identities and skip Mini Programs without privileges, see [Cloud development of static websites skip Mini Program]]](https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/staticstorage/jump-miniprogram.html) . In line with the open range of Mini programs can under the support of open Mini programs SMS
    2. This feature basically covers the current user is using the WeChat version, developers do not need to be compatible with the lower version
    3. URL Scheme that can only generate published Weixin Mini Program
    4. When jumping to WeChat via URL Scheme, the system may trigger a pop-up box query. If the user chooses not to jump, Weixin Mini Program cannot be opened.Ask developers to properly handle scenarios where users choose not to jump
    5. Some browsers will limit the opening of the page directly to the jump, please refer to the sample page to set the jump button
    6. The platform has a security policy to prevent the developer's link from being opened in batch by black ash production, which leads to the problem that the access limit cannot be opened properly. Weixin Mini Program

    # Scope of Openness

    Open to non-personal subjects Weixin Mini Program.

    # sample code

    The example uses cloud development static web hosting to build a web page, without Official Account, just prepare Weixin Mini Program and open cloud development.The page will determine which way to jump, if detected in the WeChat client, using the open tag jump without authentication, if detected in an external browser or App, using the URL Scheme jump Mini Program.

    Sample web page address: https://postpay-2g5hm2oxbbb721a4-1258211818.tcloudbaseapp.com/jump-mp.html

    Detailed code example and explaination: cloud development static website jump Weixin Mini Program .