デベロッパー向けリソース



Queue-Fairの追加

Queue-Fairバーチャル待合室は、様々なウェブやアプリのプラットフォームに数分で簡単に追加できます。 アダプタのいずれかを使用するだけです。 Queue-Fairを既存のシステムに統合する最適な方法については、テクニカルガイド、またはQueue-Fairポータル>ヘルプセクションで詳細をご覧いただけます。 ボットや人間による複数の注文を阻止する方法や、NFT販売を過剰なガス料金から保護する方法についての情報をお探しの場合は、この概要をお読みいただくか、ポータルのセキュリティガイドのセクションで完全な詳細をご確認ください。

クライアント側アダプタ

Webサイトの場合、Queue-Fairと統合する最も簡単な方法は、Client-Side Queue-Fair Adapter JavaScriptタグをページに追加することです。 サイト上のすべてのページにアダプタを安全に追加し、Queue-Fairポータルのアクティベーションルールを使用して、どのページがキューを投げるかを決定することができます。

Client-Side Adapter は訪問者のブラウザ上で動作するため、技術力のある訪問者は無効にすることができますが、JavaScript を改ざんしてキューをスキップしようとする人はごく少数なので、過負荷を防ぐのに非常に効果的です。 クライアントサイドアダプタは、サイトのクラッシュを防ぐのに効果的であり、インストールが簡単で、当社のシステムとお客様のシステムの間に依存関係が生じないため、当社のお客様のほとんどがクライアントサイドアダプタを使用しています。

JavaScriptタグをServer-Side Adapterに置き換えてセキュリティレイヤーを追加したり、JavaScript Adapterの柔軟性とこのページで説明するHybrid Security Modelを組み合わせれば、どちらの方法でもセキュリティを確保することができます。

シングルライン・オブ・コード

Client-Side Adapter をサイトに追加するには、次の一行のコードを <head> の部分があります。:

この1行のコードで、あなたのサイトにバーチャル待合室を追加し、ウェブサイトのクラッシュを防ぐことができます。

という文字を入れるお客様もいらっしゃいます。 defer タグを使用すると、ページの解析と並行して Adapter スクリプトがダウンロードされ、 ページの解析が終了してから (つまり通常はページ上の他のスクリプトが終了してから) 訪問者のブラウザ上でスクリプトの実行が開始されるようになります。

deferという単語を追加すると、場合によってはTime to First Paintを1秒単位で改善できますが、これを選択すると、キューに入れられるべき訪問者が、キューに入れられる前に保護されたページを見る時間が1秒単位で長くなることを意味します。

Googleタグマネージャ

また、Google Tag Managerを利用したJavaScript Adapter Tagも提供しています。 Community Templates Galleryの「Add Tag」でQueue-Fairを検索してください。 一部の広告ブロッカーは、Googleからのマスターgtm.jsのダウンロードを妨げ、これらの訪問者のためのアダプタの実行を含むGoogle Tag Managerのすべての操作をブロックすることに注意してください。Googleタグマネージャ用バーチャル待合室タグ

GitHubリポジトリ

Googleタグマネージャ

Googleタグマネージャ

Queue-Fair バーチャル待合室 Google タグマネージャ クライアントサイドアダプタタグの GitHub リポジトリです。.

ダイナミックキューページ

クライアントサイドJavaScriptタグとGoogleタグマネージャの実装で利用可能なdata-queue-fair-extra属性を使用することにより、お客様のサイトから弊社のサーバーおよび訪問者が見るキューページに任意のデータを渡すことができます。お客様のアカウントでダイナミックキューページを有効にする場合は、サポートにお問い合わせください。

この機能を使用して、キューページをその場でカスタマイズすることができます。 また、Queue-Fairを使用することで、キューを通過した訪問者のデータをお客様のサイトに戻すことができ、セキュリティが強化されます。

また、キューページのあらゆる側面をカスタマイズするために余分なデータを使用する動的キューページAPIを提供しています。したがって、Queue-Fairポータルで

キューページに変更を加えることなく、サイト全体で1つのキューを作成し、サイト上の異なるイベントや製品に応じて自動的にカスタマイズすることができます。



Shopify, Wordpress & WooCommerce

WooCommerceショッピングカートシステムのようなWordpress ベースのサイトを使用している場合、Wordpress Insert Headers & Footers プラグインを使用して、テーマの変更や Wordpress コードに触れることなく、簡単に Client-Side JavasScript Adapter タグを追加することができます。

Insert Headers & Footers Pluginをダウンロードし、/wp-content/plugins/フォルダに解凍し、Pluginsメニューからプラグインを有効化し、設定メニューからプラグインを開き、図のようにHeaderのScriptsにタグを加え、ページ下部の保存ボタンを押すと完了です。

Shopifyも同様に簡単です。以下は、Queue-Fair Client-Side JavaScript AdapterをShopifyストアに追加するための手順です。

Queue-Fairポータルダッシュボード

クライアントサイドアダプタ その他のリソース

Client-Side Adapterについては、テクニカルガイドで詳しく説明しています。 テクニカルガイドは、Queue-Fairポータル>ヘルプに掲載されていますが、弊社にご請求いただくことも可能です。


サーバーサイドアダプター

Client-Side Adapterが訪問者のブラウザ上のJavaScriptで動作するのに対し、Queue-Fair Server-Side AdapterはWebサーバー上で動作します。

ウェブサーバーアダプター

これは、Web サーバーが追加のセキュリティ機能を利用して、キューに 入れていない人のアクセスを拒否できることを意味します。 また、WebサーバーはAdapterスクリプトを含むページの生成や配信の負荷を回避することができます。

Queue-Fair サーバーサイドアダプターライブラリを追加すると、 アダプターを有効化して実行するための最小限のコード変更で、わずか数分しかかかりません。

多くのお客様は、まずクライアントサイドのJavaScriptアダプターから始め、特定のビジネスニーズがある場合にのみサーバーサイドアダプターに移行しています。

シンプル&セーフモード

Queue-Fairサーバーサイドアダプターは、シンプルモードまたはセーフモードで動作可能です。

シンプルモードでは、キューが形成されているかどうかに関わらず、すべての訪問者がQueue-Fairサーバに送られ、カウントされます。 しかし、キューに入れられた人だけが保護されたリソースにアクセスできるようにするために、Webサーバに必要な署名が付与されます。

セーフモードでは、キューが存在するときのみ、訪問者はQueue-Fairサーバーに送られます。 お客様のウェブサーバーは、キューサーバーに直接アクセスしてこの判断を行います。 キューページが表示されているかどうかにかかわらず、訪問者は安全にデジタル署名されます。

セーフモードは、日常的なキューにお勧めします。 シンプルモードは、数千人を想定した時間制のイベントに適しています。お客様のウェブサーバーからキューサーバーへのチェックコールによる待ち時間をなくし、より効率的にキューに人を送ることができるからです。

GitHubリポジトリ

PHP バーチャル待合室アダプタ') ?>

PHP

PHP による Queue-Fair 仮想待合室サーバーサイドアダプタの GitHub リポジトリです。

Java仮想待合室アダプタ

Java

JBossやTomcatを含むJava用のQueue-Fair Virtual Waiting Room Server-Side AdapterのGitHubリポジトリです。

Ruby仮想待合室アダプタ

Ruby

Queue-Fair仮想待合室サーバサイドアダプタのGitHubリポジトリ(Rubyおよび(オプションの)Rails版.

Python仮想待合室アダプタ

Python

Python および (オプションで) Django による Queue-Fair 仮想待合室サーバーサイドアダプタの GitHub リポジトリです。

dotNet バーチャル待合室アダプタ

.NET

Queue-Fair Virtual Waiting Room Server-Side Adapter for .NET, ASP, C# のGitHubリポジトリです。

Node.js & JavaScript 仮想待合室アダプタ

Node.js & JavaScript

Node.jsおよび(オプションの)Express用のQueue-Fair仮想待合室サーバーサイドアダプタのGitHubリポジトリです。



ダイナミックキューページ

Client-Side Adapter と同様に、Server-Side Adapter の呼び出しで情報を渡すことで、 お客様のウェブサーバから弊社のサーバや、訪問者が見るキューページに、 必要なデータを渡すことができます。 これにより、ダイナミックキューページやその他のオンザフライのカスタマイズを同様に行うことができます。クライアントサイドアダプタのすべての機能が完全にサポートされています。Dynamic Queue Page を有効にする場合は、サポートにご連絡ください。

サーバーサイドアダプター その他のリソース

Server-Side Adaptersについては、テクニカルガイドで詳しく説明しています。 テクニカルガイドは、Queue-Fairポータル > ヘルプセクションに掲載されていますが、弊社にご請求いただくことも可能です。 また、各アダプタの詳細については、各GitHubリポジトリのREADME.mdに記載されています。


ネットワークエッジアダプタ

Queue-Fair Network-Edge Adaptersは、訪問者のブラウザやオリジンサーバーではなく、CDNやクラウドサービスプロバイダーのフレームワークの中で実行されます。

LambdaとCDNプロバイダアダプタ

これにより、Server-Side Adapterと同様のセキュリティと、Direct Linkと同様の負荷保護が実現されます。

Queue-Fair Network-Edge Adapterライブラリを追加すると、クラウドプロバイダーでのコードの変更は最小限に抑えられ、わずか数分でAdapterを有効化し実行できます(通常はLambda関数またはEdge Workerとしてデプロイされます)。

シンプル&セーフモード

ネットワークエッジアダプターは、サーバーサイドアダプターと同様に、シンプルモードとセーフモードで動作させることができます。

使用可能なアダプター

Amazon AWS CloudFront Network-Edge 仮想待合室アダプタ') ?>

CloudFront

Amazon AWS CloudFront Network-Edge Virtual Waiting Room Adapter。

Cloudflare Network-Edge 仮想待合室アダプタ

Cloudflare

Cloudflare Network-Edge 仮想待合室アダプタ

Fastly Network-Edge Virtual Waiting Room Adapter(仮想待合室アダプタ)。

Fastly

Fastly Network-Edge Virtual Waiting Room Adapter..

Akamai Network-Edge Virtual Waiting Room Adapter(アカマイ・ネットワーク・エッジ・バーチャル・ウェイティング・ルーム・アダプター

Akamai

Akamai Network-Edge Virtual Waiting Room Adapter(アカマイ・ネットワーク・エッジ・バーチャル・ウェイティング・ルーム・アダプター)。



ダイナミックキューページ

クライアントサイドアダプタと同様、アダプタの呼び出しで情報を渡すことで、 お客様のサイトから私たちのサーバや、訪問者が見るキューページに、 必要なデータを渡すことができます。 これにより、ダイナミックキューページやその他のオンザフライのカスタマイズが同じように容易になります。クライアントサイドアダプタのすべての機能が完全にサポートされています。アカウントで動的キューページを有効にしたい場合は、サポートにご連絡ください。

ネットワーク・エッジ・アダプタ その他のリソース

ネットワークエッジアダプターについては、テクニカルガイドで詳しく説明しています。 テクニカルガイドは、Queue-Fairポータル > ヘルプセクションで入手可能ですが、弊社からコピーを請求することもできます。 また、各GitHubリポジトリのREADME.mdには、各アダプタの詳細な情報が記載されています。


REST API

Queue-Fairは、開発者に6つのREST API Moduleへのアクセスを提供します。 APIを使用するには、Queue-Fairのアカウントが必要です。 お客様のアカウントでAPIアクセスを有効にするには、Queue-Fairサポートにお問い合わせください。 REST APIモジュールは、OpenAPI、RFC 7807、RFC 3339の各規格に準拠しています。

ポータルでできることはすべてAPIでも可能です。ただし、プライバシー保護の観点から、ポータルユーザーの管理は除外されています。

各APIモジュールはapi.queue-fair.net で完全に文書化されており、使いやすさとテストのための Swagger インターフェースも見つかります。 セキュリティのため、すべてのAPIコールは安全なTLS暗号化によって保護され、お客様のアカウントに固有のAPIキーが必要です。

APIモジュール

レポーティングAPI

ライブ、リアルタイムレポート、ヒストリカルレポート、キュー統計の集計に。

キュー管理API

プログラムによるキューの作成と変更をリアルタイムに行うことができます。

アカウント管理API

アカウント全体の設定の表示と更新のため。

アセットマネジメントAPI

Google CDNで配信されるキューページで使用するアセットを管理するためのものです。

プレゼンテーションAPI

キューページのHTMLを変更したり、バリアントをその場で更新・作成したりすることができます。

アクティベーションAPI

サイト上のどのページがキューをトリガーし、どのページが表示されるかを決定するActivation Rulesを設定するためのものです。



ダイナミックキューページ

また、ポータルやプレゼンテーションAPIを使用して、データベースを更新することなく、その場でキューページを変更することも可能です。詳細やアカウントでダイナミックキューページを有効にするには、サポートにお問い合わせください。

REST API その他のリソース

RFC 7807 の要求に従い、弊社の REST API モジュールが返す可能性のあるエラーメッセージに関する文書をqueue-fair.com/api-errorで見つけることができます。


ネイティブアプリ

Queue-Fairは、デスクトップやラップトップだけでなく、モバイルブラウザでも美しく表示されます。

また、Queue-FairをiOSやAndroidのネイティブアプリ、さらにiOS、Android、Windows、MacOSのReact Nativeアプリで直接使用し、リソース集約型のアクティビティやオペレーションを保護することも可能です。

Queue-Fair App Adaptersは、WebClientを使用して、サービスが混雑しているときに、ユーザーにカスタムキューを表示するための柔軟性と使いやすさを備えています。 Queue-Fair Portal.

Webサイトの訪問者と同じキューに入れるか、アプリのユーザー用に別のキューを設定するか、それはあなた次第です。

ウェブベースのキューと同様に、ユーザーがアプリから移動した場合も、各ユーザーの場所は自動的に保存されます。

GitHubリポジトリ

iOS、MacOS、Apple バーチャル待合室アダプタ

iOS & MacOS

Queue-Fair Virtual Waiting Room iOS/MacOS用アダプタのGitHubリポジトリです。

Androidバーチャル待合室アダプタ

Android

Queue-Fair Virtual Waiting Room Adapter for AndroidのGitHubリポジトリです。

React Nativeアプリ 仮想待合室アダプタ

React Native

Android、iOS、MacOS、Windows向けReact Nativeアプリ用Queue-Fair仮想待合室アダプタのGitHubリポジトリです。

キュー通知

Queue-Fair Adapterを使用すると、アプリやキューを使用していないユーザーに対して、自分の順番が呼ばれたときにPush通知を簡単に送信することができます。 キュー内のユーザーの位置は、アダプタによって自動的にアプリに永続的に保存されます。 ユーザがアプリから離れた場合、アプリはPush通知サーバに通知を送信するよう指示し、保存されたキューの位置情報をPush通知サーバにメッセージの一部として送信します。

これは、英国だけで約200万ダウンロードを記録したWeQ4Uコンシューマー向けアプリと同じ技術です。

Push Notificationサーバーは、Queue-Fair Status APIを定期的に参照し、現在提供されているキューの位置を照会します。 これが特定のユーザーのキュー位置よりも大きい場合、そのユーザーに通知を送信するタイミングとなります。 Push Notification が送信される前にユーザがキューに戻ったり、Passed された場合、アダプタはアプリに通知し、アプリは Push Notification サーバに通知が不要になったことを通知します。

この機能をサポートしている仮想待合室プロバイダーは、私たちの知る限り、私たちだけです。

ビデオリソース

Native App Adapter の動作のビデオです。アプリが完全に停止してもユーザーの場所は保存されることを示し、アプリが Push Notification を送信するために使用する Adapter フックも示しています。

その他のリソース

当社のNative App Adaptersは、テクニカルガイドに記載されています。 テクニカルガイドは、Queue-Fairポータル>ヘルプに掲載されていますが、弊社にご請求いただくことも可能です。 また、iOSやAndroidに特化した各Adapterの詳細は、各GitHubリポジトリのREADME.mdに記載されています。


ECアダプタ

Queue-Fairは、上記のClient-Side JavaScript Adapterを使用して、あらゆるeコマースシステムに簡単に追加することができます。

また、多くの一般的なeコマースサーバーでサーバーサイドで動作するAdapterコードも提供しています。

GitHubリポジトリ

Magento Plugin

Magento

Queue-Fair Virtual Waiting Room Adapter for MagentoのGitHubリポジトリです。

WooCommerce/PHP バーチャル待合室アダプタ

WooCommerce

PHPで作られたWooCommerce用Queue-Fair仮想待合室アダプタのGitHubリポジトリです。

PrestaShop/PHP バーチャル待合室 アダプター

PrestaShop

PrestaShop用Queue-Fair仮想待合室アダプタ(PHP製)のGitHubリポジトリです。

その他のリソース

弊社のアダプターは、テクニカルガイドに記載されています。 テクニカルガイドは、Queue-Fairポータル>ヘルプに掲載されていますが、弊社にご請求いただくことも可能です。

また、ほとんどのeコマース・プラットフォームに対応した補足ガイドもご用意しています。


ハイブリッド・セキュリティ

Client-Side JavaScript Adapter の柔軟性と、Server-Side のコードで提供される追加のセキュリティ層を簡単に組み合わせることができます。

Queue-Fairは、パスした各ビジターにそのビジター固有のデジタルフィンガープリントで署名します。 この業界では珍しく、署名にはビジターのブラウザに固有のコードも含まれており、アクセストークンが共有されることを防ぎます。

お客様のウェブサーバーは、お客様の訪問者ではなく、お客様と弊社だけが知っている秘密を使用して署名を検証し、各訪問者がQueue-Fairサーバーを公正に通過したことを確認することができます。

そこで、Client-Side JavaScript Adapter を使って、キューに訪問者を送受信し、注文前に改ざんがないかどうかを最小限の Server-Side コードでチェックし、我々のシステムへの依存関係を持ち込まないようにすることができるのです。

GitHub Repositoriesには、主要なWebプログラミング言語でのサンプルコードが含まれています。

GitHubリポジトリ

PHP

PHP

PHP による Queue-Fair 仮想待合室サーバーサイドアダプタの GitHub リポジトリです。

Java

Java

JBossやTomcatを含むJava用のQueue-Fair Virtual Waiting Room Server-Side AdapterのGitHubリポジトリです。

Ruby

Ruby

Rubyおよび(オプションの)RailsによるQueue-Fair仮想待合室サーバーサイドアダプターのGitHubリポジトリです。

Python

Python

Python および (オプションで) Django による Queue-Fair 仮想待合室サーバーサイドアダプタの GitHub リポジトリです。

.NET

.NET

Queue-Fair Virtual Waiting Room Server-Side Adapter for .NET, ASP, C# のGitHubリポジトリです。

Node.js & JavaScript Virtual Waiting Room Adapter') ?>

Node.js & JavaScript

Node.jsおよび(オプションの)Express用のQueue-Fair仮想待合室サーバーサイドアダプタのGitHubリポジトリです。

その他のリソース

ハイブリッドセキュリティモデルについては、テクニカルガイドで完全に説明されています。 テクニカルガイドは、Queue-Fairポータル > ヘルプセクションで入手できます。


ライセンス

GitHub Queue-Fair Repositoryで公開されているコードは、オープンソースライセンスの中でも最も寛容なMITライセンスのもとでライセンスされています。


Queue-Fairの仕組みについて知りたいですか?