WeChat ミニ プログラム ----テキスト メッセージ、電子メール、WeChat 外部の Web ページ、および URLScheme または URLLink を介したその他のシナリオからミニ プログラムを開きます。
モバイル
2024-03-16 07:46:29
訪問数: null
1. テキストメッセージ、電子メール、Webページ、WeChatなどを介してミニプログラムを起動する方法。
- 「URL スキームによるミニ プログラムの開始」
- 「URL リンクでミニ プログラムが起動します」
2. 機能説明
- URL スキーム: このインターフェイスは、ミニ プログラムのスキーム コードを取得するために使用され、テキスト メッセージ、電子メール、外部 Web ページ、WeChat などを介してミニ プログラムが起動されるビジネス シナリオに適しています。現在は国内非個別科目のミニプログラムのみ公開されています 詳細は「URLスキームの取得」を参照してください。
- URL リンク: ミニ プログラムの URL リンクを取得します。ミニ プログラムがテキスト メッセージ、電子メール、Web ページ、WeChat などを通じて起動されるビジネス シナリオに適しています。現在は国内非個別科目のミニプログラムのみ公開しておりますので、詳しくはURLリンクの取得をご覧ください。
3.コール上限額
- 生成終了: 1 日に生成される URL スキーム (暗号化された平文) と URL リンクの総数は 500,000 に制限されます。
- オープン側: URL スキーム (暗号化されたプレーン テキスト) および URL リンクを通じてミニ プログラムを開くことができる合計回数は、1 日あたり 300 万回に制限されます。
- 2023 年 12 月 19 日以降、リンクごとに 1 人という URL スキーム制限が解除され、同じ接続に複数のユーザーがアクセスできるようになります。調整手順の詳細については、「URL スキームと URL リンクの最適化に関するお知らせ」を参照してください。
4. その他注意事項
4.1 URLスキーム
- 暗号化された URL スキームは、開発者がリンクの後にクエリ パラメーターを結合することをサポートします。詳細については、「URL スキームの取得」を参照してください。
- WeChat の Web ページでミニ プログラムを開く必要がある場合は、WeChat の [開く] タブ - ミニ プログラム ジャンプ ボタンを使用してください。パブリック アカウントをお持ちでない場合は、ミニ プログラム ID を直接使用して Web ページを開発し、認証なしでミニ プログラムにジャンプします。クラウド開発の静的 Web サイトを参照してミニ プログラムにジャンプします。オープン スコープを満たすミニ プログラムは、ミニ プログラムを開くことをサポートするテキスト メッセージを送信できます。
- この機能は基本的にユーザーが現在使用している WeChat のバージョンをカバーしており、開発者は下位バージョンと互換性を持たせる必要はありません。
- 生成できるのは公開されたアプレットの URL スキームのみです。
- URL スキームを介して WeChat にジャンプすると、システムのポップアップ ボックスが表示され、質問が表示されることがあります。ユーザーがジャンプしないことを選択した場合、ミニ プログラムを開くことはできません。開発者は、ユーザーがジャンプしないことを選択したシナリオを適切に処理することが求められます。
- ブラウザによってはWebページを開いた際の直接ジャンプが制限されている場合がありますので、サンプルWebページを参照してジャンプボタンを設定してください。
4.2 URLリンク
- 暗号化された URL リンクは、開発者がリンクの背後でクエリ パラメーターを結合できるようにします。詳細については、「URL リンクの取得」を参照してください。
- 生成できるのは、公開されたミニ プログラムの URL リンクのみです。
- WeChat または Android スマートフォンで URL リンクを開くと、デフォルトで公式 H5 中間ページが最初にリダイレクトされます。H5 コンテンツをカスタマイズする必要がある場合は、クラウドを使用して静的 Web サイトを開発できます。
5.呼び出し方法
5.1 HTTPS 呼び出し
- URLスキーム:POST https://api.weixin.qq.com/wxa/generatescheme?access_token=ACCESS_TOKEN;
- URLリンク:POST https://api.weixin.qq.com/wxa/generate_urllink?access_token=ACCESS_TOKEN。
5.2 クラウド通話
- URL スキーム: インターフェイス メソッドは次のとおりです: openapi.urlscheme.generate;
- URL リンク: インターフェイス メソッドは、openapi.urllink.generate です。
5.3 サードパーティ通話
1. URLスキーム
- 呼び出しメソッドと受信および送信パラメータは HTTPS と同じですが、呼び出しトークンのみが異なります。
- このインターフェイスが属する権限セット ID は次のとおりです: 88、115;
- サービス プロバイダーは、アクセス許可セットの 1 つから承認を取得した後、authorizer_access_token を使用して、マーチャントに代わって呼び出しを行うことができます。
2. URLリンク
- 呼び出しメソッドと受信および送信パラメータは HTTPS と同じですが、呼び出しトークンのみが異なります。
- このインターフェイスが属する権限セット ID は次のとおりです: 88、115;
- サービス プロバイダーは、アクセス許可セットの 1 つから承認を取得した後、authorizer_access_token を使用して、マーチャントに代わって呼び出しを行うことができます。
6. リクエストパラメータ
6.1 URLスキーム
- パラメータの説明
属性 |
タイプ |
デフォルト値 |
必須 |
説明する |
アクセストークン |
弦 |
|
はい |
インターフェース呼び出し資格情報 |
ジャンプ何 |
物体 |
|
いいえ |
ジャンプ先のターゲット アプレットに関する情報。 |
有効期限 |
番号 |
|
いいえ |
期限切れのスキーム コードの有効期限は Unix タイムスタンプです。生成された有効期限スキーム コードは、この時点まで有効です。最大有効期間は 30 日間です。is_expire が true で、expire_type が 0 の場合は必須 |
有効期限の種類 |
番号 |
|
いいえ |
デフォルト値 0、有効期限スキーム コード失敗タイプ、有効期限: 0、有効期限間隔日数: 1 |
期限切れの間隔 |
番号 |
|
いいえ |
期限切れのスキーム コードの有効期限間の日数。生成された有効期限スキーム コードは、間隔に達するまで有効です。最大間隔は 30 日です。is_expire が true で、expire_type が 1 の場合は必須です。 |
- 説明
属性 |
タイプ |
デフォルト値 |
必須 |
説明する |
パス |
弦 |
|
いいえ |
スキーム コードを通じて入力されたミニ プログラム ページのパスは、公開されたミニ プログラムが存在するページである必要があり、クエリは実行できません。パスが空の場合は、ミニプログラムのホームページにジャンプします。 |
クエリ |
弦 |
|
いいえ |
スキーム コードを通じてミニ プログラムに入るときのクエリの最大長は 1024 文字です。数字、大文字と小文字の英語、および一部の特殊文字 (!#$&'()*+,/:;=?@-) のみをサポートします。 ._~%` |
環境バージョン |
弦 |
|
いいえ |
デフォルト値は「リリース」です。開くアプレットのバージョン。正式版は「リリース」、体験版は「試用版」、開発版は「開発」となっており、WeChat外で開いた場合のみ有効となります。 |
6.2 URLリンク
- パラメータの説明
属性 |
タイプ |
デフォルト値 |
必須 |
説明する |
アクセストークン |
弦 |
|
はい |
インターフェース呼び出し資格情報 |
パス |
弦 |
|
いいえ |
URL リンクを通じて入力されたミニ プログラム ページのパスは、公開されたミニ プログラムが存在するページである必要があり、クエリは実行できません。パスが空の場合は、ミニプログラムのホームページにジャンプします。 |
クエリ |
弦 |
|
いいえ |
URL リンク経由でミニ プログラムに入るときのクエリの最大長は 1024 文字で、数字、大文字と小文字の英語、および一部の特殊文字 (!#$&'()*+、/:;=?@-) のみがサポートされます。 _~% |
有効期限 |
番号 |
|
いいえ |
期限切れの URL リンクの有効期限は Unix タイムスタンプです。生成された期限切れの URL リンクは、この時点まで有効です。最大有効期間は 30 日間です。expire_type は 0 です 必須です |
有効期限の種類 |
番号 |
|
いいえ |
デフォルト値は 0。 ミニ プログラム URL リンクの有効期限タイプ、有効期限: 0、有効期限間隔日数: 1 |
期限切れの間隔 |
番号 |
|
いいえ |
期限切れの URL リンクの有効期限までの日数。生成された期限切れの URL リンクは、間隔に達するまで有効です。最大間隔は 30 日です。expire_type は 1 が必要です |
クラウドベース |
物体 |
|
いいえ |
クラウド開発された静的 Web サイトは、H5 構成パラメーターをカスタマイズし、転送されたクラウド開発された H5 ページを構成できます。空白のままにすると、デフォルトで公式 H5 ページが使用されます。 |
環境バージョン |
弦 |
|
いいえ |
デフォルト値は「リリース」です。開くアプレットのバージョン。正式版は「リリース」、体験版は「試用版」、開発版は「開発」となっており、WeChat外で開いた場合のみ有効となります。 |
- クラウドベースの説明
属性 |
タイプ |
デフォルト値 |
必須 |
説明する |
環境 |
弦 |
|
はい |
クラウド開発環境 |
ドメイン |
弦 |
|
いいえ |
静的 Web サイトのカスタム ドメイン名。空白のままにすると、デフォルトのドメイン名が使用されます。 |
パス |
弦 |
|
いいえ |
クラウド開発の静的 Web サイトの H5 ページ パス、クエリは実行できません |
クエリ |
弦 |
|
いいえ |
クラウド開発の静的 Web サイトの H5 ページ クエリ パラメーター、最大 1024 文字、数字、大文字と小文字の英語、および一部の特殊文字のみサポート: !#$&'()*+,/:;=?@-._~%` |
resource_appid |
弦 |
|
いいえ |
サードパーティのバッチ クラウド開発に必要で、env (ミニ プログラム/サードパーティ プラットフォーム) を作成するための appid を示します。 |
7. 注意
URL リンクの一部によって返された url_link は、QQ ブラウザによってインターセプトされます。!!なので、今のところはまだ URL スキームを使用しています。!!

転載: blog.csdn.net/m0_38082783/article/details/135381618