パラメータを使用して QR コードを生成する

ユーザー チャネル プロモーション分析やユーザー アカウント バインディングなどのシナリオのニーズを満たすために、パブリック プラットフォームは次の機能を提供します。パラメータコードインターフェイスを使用して 2 次元パラメータを生成します。このインターフェースを使用すると、シーン値の異なる複数の QR コードを取得でき、ユーザーがスキャンした後、パブリック アカウントはイベント プッシュを受け取ることができます。

現在 2 種類の QR コードがあります:

1. 一時的な QR コードには有効期限があり、QR コードの生成後最大 30 日間に設定できます (つまり、 、2,592,000 秒後に期限切れになります）が、より大量に生成される可能性があります。一時的な QR コードは主に、QR コードの永続的な保存を必要としないアカウント バインディングなどのビジネス シナリオで使用されます。
2. 永続的な QR コードには有効期限はありませんが、数は少ないです (現在最大 100,000)。永続的な QR コードは、主にアカウント バインドやユーザー ソース統計などのシナリオで使用されます。

ユーザーがシーン値を含む QR コードをスキャンすると、次の 2 つのイベントがプッシュされる可能性があります:

ユーザーが公式アカウントをフォローしていない場合、ユーザーは公式アカウントをフォローできます。アカウントを取得し、WeChat でフォローすると、シーン値を含むアテンション イベントが開発者にプッシュされます。

ユーザーが公式アカウントをフォローしている場合、ユーザーはスキャン後に自動的にセッションに入り、WeChat もシーン値を含むスキャン イベントを開発者にプッシュします。

パラメータ付き QR コードの取得プロセスは、QR コード チケットを作成し、そのチケットを使用して指定された URL にアクセスして QR コードと交換する 2 つのステップで構成されます。

QR コード チケットの作成

QR コード チケットを作成するたびに、開発者が設定したパラメーター (scene_id) を指定し、一時的な QR を導入する必要があります。コードを個別に作成し、永久 QR コード チケットを作成するプロセス。

一時的な QR コード リクエスト手順

永続的 QR コード リクエストの手順

パラメータの説明

#action_nameQR コード タイプ、QR_SCENE は一時的、QR_LIMIT_SCENE は永続的、QR_LIMIT_STR_SCENE は永続的な文字列パラメータ値です。action_info QR コードの詳細scene_id一時 QR コードが使用される場合、これは 32 ビットの 0 以外の整数です。永久 QR コードの最大値は 100000 です (現在、パラメータは 1 ～ 100000 のみをサポートしています) scene_strシーン値 ID (文字列形式の ID)、文字文字列タイプ、長さは 1 ～ 64 に制限されています。永続的な QR コードのみがこのフィールドをサポートします。

返却手順

パラメータ	説明
expire_seconds	この QR コードの有効時間は秒単位で測定されます。最大値は 2592000 (つまり 30 日) を超えることはできません。このフィールドが入力されていない場合、デフォルトの有効期間は 30 秒です。

#パラメータ説明チケット取得したQR有効期限内にQRコードと交換できるコードチケット。 expire_secondsこの QR コードの有効期限 (秒単位)。最大値は 2,592,000 (つまり 30 日) を超えません。 #url#

チケットによる QR コードの交換

QR コード チケットを取得した後、開発者はチケットを QR コード画像と交換できます。このインターフェースはログインせずに呼び出すことができることに注意してください。

リクエストの説明

ticket 正しい場合、http リターン コードは 200 です。これは、次のようなイメージです。直接表示またはダウンロードできます。

エラー(不正なチケットなど)の場合、HTTP エラー コード 404 が返されます。

#

QR コード画像を解析した後のアドレス。開発者はこのアドレスに基づいて必要な QR コード画像を生成できます