Sumber Daya Pengembang



Menambahkan Queue-Fair

Ruang Tunggu Virtual Queue-Fair mudah ditambahkan ke berbagai macam platform web dan aplikasi dalam hitungan menit. Cukup gunakan salah satu Adaptor kami. Anda dapat menemukan informasi lebih lanjut tentang cara terbaik untuk mengintegrasikan Queue-Fair dengan sistem yang ada di Panduan Teknis, atau Portal Queue-Fair > bagian Bantuan. Jika Anda mencari informasi tentang cara menghentikan bot atau manusia membuat banyak pesanan, atau melindungi penjualan NFT Anda dari biaya gas yang berlebihan, Anda dapat membaca ikhtisar ini atau mendapatkan detail lengkap di bagian Panduan Keamanan Portal.

Adaptor Sisi Klien

Untuk situs web, cara paling sederhana untuk berintegrasi dengan Queue-Fair adalah dengan menambahkan tag JavaScript Adaptor Queue-Fair Sisi Klien ke halaman Anda. Anda dapat dengan aman menambahkan Adaptor ke semua halaman di situs Anda, dan menggunakan Aturan Aktivasi di Portal Queue-Fair untuk menentukan halaman mana yang dapat melempar antrian.

Karena berjalan di browser pengunjung Anda, Adaptor Sisi Klien dapat dinonaktifkan oleh pengunjung yang memiliki keahlian teknis, tetapi sangat efektif untuk mencegah kelebihan beban karena hanya sebagian kecil orang yang akan mencoba melewati antrean dengan mengutak-atik JavaScript. Sebagian besar pelanggan kami menggunakan Adaptor Sisi Klien karena efektif untuk mencegah situs yang macet, mudah dipasang dan tidak menimbulkan ketergantungan apa pun antara sistem kami dan sistem Anda.

Anda dapat menambahkan lapisan keamanan dengan mengganti tag JavaScript dengan Server-Side Adapter, atau menggabungkan fleksibilitas JavaScript Adapter dengan Hybrid Security Model yang dijelaskan pada halaman ini; kedua metode tersebut kemudian aman.

Baris Tunggal Kode

Untuk menambahkan Client-Side Adapter ke situs Anda, cukup tambahkan satu baris kode berikut ini ke <head> bagian dari halaman Anda:

Tambahkan Ruang Tunggu Virtual kami ke situs Anda dengan satu baris kode ini dan cegah situs web crash

Sebagian pelanggan menambahkan kata defer ke tag, yang menyebabkan skrip Adaptor diunduh secara paralel dengan penguraian halaman dan juga hanya memulai eksekusi skrip di browser pengunjung ketika halaman telah selesai diurai (jadi biasanya setelah skrip lain di halaman Anda selesai).

Menambahkan kata defer dapat meningkatkan Waktu ke Cat Pertama dengan sepersekian detik dalam beberapa kasus, tetapi jika Anda memilih untuk melakukan ini, itu berarti bahwa setiap pengunjung yang harus antri akan melihat halaman terlindungi Anda untuk sepersekian detik lebih lama sebelum mereka dikirim ke antrian.

Pengelola Tag Google

Kami juga menyediakan Tag Adaptor JavaScript melalui Google Tag Manager. Cari Queue-Fair di Galeri Templat Komunitas, di bawah Tambah Tag. Harap dicatat bahwa beberapa pemblokir iklan mencegah pengunduhan master gtm.js dari Google, yang memblokir semua operasi Google Tag Manager, termasuk menjalankan Adaptor untuk pengunjung tersebut.Tag Ruang Tunggu Virtual kami untuk Google Tag Manager

Repositori GitHub

Pengelola Tag Google

Pengelola Tag Google

Repositori GitHub untuk Ruang Tunggu Virtual Queue-Fair Tag Adapter Sisi Klien Google Tag Manager.

Halaman Antrian Dinamis

Data apa pun yang Anda inginkan dapat diteruskan dari situs Anda ke server kami dan Halaman Antrian yang dilihat pengunjung Anda dengan menggunakan atribut data-antrian-berkeadilan-ekstra yang tersedia dalam Tag JavaScript Sisi Klien dan implementasi Google Tag Manager. Silakan hubungi dukungan jika Anda ingin mengaktifkan Halaman Antrian Dinamis pada akun Anda.

Anda dapat menggunakan fitur ini untuk menyesuaikan Halaman Antrian dengan cepat. Anda juga dapat menggunakan Queue-Fair untuk meneruskan data yang Anda kirimkan kepada kami dengan pengunjung Anda kembali ke situs Anda saat mereka dilewati oleh antrian, untuk lapisan keamanan tambahan.

Kami juga menyediakan API Halaman Antrian Dinamis yang menggunakan data tambahan untuk menyesuaikan aspek apa pun dari Halaman Antrian, sehingga Anda dapat membuat satu antrian untuk seluruh situs Anda dan menyesuaikannya secara otomatis untuk acara atau produk yang berbeda di situs Anda, tanpa harus membuat perubahan apa pun pada Halaman Antrian Anda di Portal Queue-Fair

.



Shopify, Wordpress & WooCommerce

Jika Anda menggunakan situs berbasis Wordpress, seperti sistem keranjang belanja WooCommerce, Anda dapat dengan mudah menambahkan tag Adaptor JavasScript Sisi Klien menggunakan Plugin Wordpress Insert Headers & Footers, tanpa harus memodifikasi Tema atau menyentuh kode Wordpress apa pun.

Cukup unduh Plugin Insert Headers & Footers, unzip ke folder / wp-content/plugins/, Aktifkan plugin di menu Plugins, buka plugin dari menu Settings, tambahkan tag ke Scripts in Header seperti yang ditunjukkan, tekan Save di bagian bawah halaman, dan selesai!

Shopify sama mudahnya - berikut adalah petunjuk untuk menambahkan Adaptor JavaScript Sisi Klien Queue-Fair ke toko Shopify Anda.

Dasbor Portal Queue-Fair

Sumber Daya Tambahan Adaptor Sisi Klien

Adaptor Sisi Klien dijelaskan sepenuhnya dalam Panduan Teknis. Panduan Teknis tersedia di bagian Portal Queue-Fair > Bantuan, atau Anda dapat meminta salinannya dari kami.


Adaptor Sisi Server

Sementara Adaptor Sisi-Klien berjalan dalam JavaScript di browser pengunjung Anda, Adaptor Sisi-Server Queue-Fair berjalan di server web Anda.

Adaptor Server Web

Ini berarti server web Anda dapat memanfaatkan fitur keamanan tambahan untuk menolak akses ke orang yang belum antri. Hal ini juga berarti server web Anda terhindar dari beban pembuatan dan penyajian halaman yang berisi skrip Adaptor.

Menambahkan libraries Queue-Fair Server-Side Adapter hanya membutuhkan waktu beberapa menit dengan perubahan kode minimal untuk mengaktifkan dan menjalankan Adapter.

Sebagian besar pelanggan kami memulai dengan Adaptor JavaScript Sisi Klien dan pindah ke Adaptor Sisi Server hanya jika ada kebutuhan bisnis tertentu.

Mode Sederhana & Aman

Adaptor Sisi Server Queue-Fair dapat beroperasi dalam mode Sederhana atau Aman.

Dalam Mode Sederhana, semua pengunjung dikirim ke Server Queue-Fair untuk dihitung, apakah sebuah Antrian telah terbentuk atau tidak. Ketika tidak ada antrian, mereka langsung dikembalikan ke Server Web Anda, tanpa melihat Halaman Antrian - tetapi dengan tanda tangan yang dibutuhkan Server Web Anda untuk memastikan bahwa hanya orang-orang yang telah dilewati oleh antrian yang dapat mengakses sumber daya Anda yang dilindungi.

Dalam Safe Mode, pengunjung hanya dikirim ke Server Queue-Fair ketika ada Antrian. Server web Anda berkonsultasi dengan Server Antrian kami secara langsung untuk membuat keputusan ini. Pengunjung masih ditandatangani secara digital dengan aman apakah Halaman Antrian ditampilkan atau tidak.

Safe Mode direkomendasikan untuk antrian sehari-hari. Mode Sederhana sesuai untuk acara berjangka waktu ketika Anda mengharapkan ribuan orang, karena mode ini menghilangkan latensi karena panggilan pengecekan dari server web Anda ke Server Antrian kami, yang berarti Anda dapat mengirim orang ke antrian dengan lebih efisien.

Repositori GitHub

Adaptor Ruang Tunggu Virtual PHP') ?>

PHP

Repositori GitHub untuk Adaptor Sisi Server Ruang Tunggu Virtual Queue-Fair dalam PHP.

Java Virtual Waiting Room Adapter

Java

Repositori GitHub untuk Queue-Fair Virtual Waiting Room Server-Side Adapter untuk Java, termasuk JBoss dan Tomcat.

Adaptor Ruang Tunggu Virtual Ruby

Ruby

Repositori GitHub untuk Adaptor Sisi Server Ruang Tunggu Virtual Queue-Fair di Ruby dan (secara opsional) Rails.

Adaptor Ruang Tunggu Virtual Python

Python

Repositori GitHub untuk Adaptor Sisi Server Ruang Tunggu Virtual Queue-Fair di Python dan (opsional) Django.

dotNet Adaptor Ruang Tunggu Virtual

.NET

Repositori GitHub untuk Adaptor Sisi Server Ruang Tunggu Virtual Queue-Fair untuk .NET, ASP, dan C #.

Node.js & JavaScript Adaptor Ruang Tunggu Virtual

Node.js & JavaScript

Repositori GitHub untuk Adaptor Sisi Server Ruang Tunggu Virtual Queue-Fair untuk Node.js dan (opsional) Express.



Halaman Antrian Dinamis

Seperti halnya Adaptor Sisi-Klien, data apa pun yang Anda inginkan dapat diteruskan dari server web Anda ke server kami dan Halaman Antrian yang dilihat pengunjung Anda dengan meneruskan informasi ini dalam panggilan Adaptor Sisi-Server. Hal ini memfasilitasi Halaman Antrian Dinamis atau kustomisasi on-the-fly lainnya dengan cara yang sama - semua fitur Client-Side Adapter didukung sepenuhnya. Silakan hubungi bagian dukungan jika Anda ingin mengaktifkan Halaman Antrian Dinamis pada akun Anda.

Sumber Daya Tambahan Adaptor Sisi Server

Adaptor Sisi-Server kami sepenuhnya dijelaskan dalam Panduan Teknis. Panduan Teknis tersedia di bagian Portal Queue-Fair > Bantuan, atau Anda dapat meminta salinannya dari kami. Anda juga dapat menemukan informasi lebih lanjut tentang masing-masing Adaptor di README.md dari setiap repositori GitHub.


Adaptor Tepi Jaringan

Adapter Network-Edge Queue-Fair berjalan di dalam CDN atau kerangka kerja penyedia Layanan Cloud Anda, bukan di browser pengunjung atau di server asal Anda.

Adaptor Penyedia Lambda dan CDN

Hal ini memberikan keamanan yang sama dengan Server-Side Adapter dan perlindungan beban yang sama dengan Direct Link.

Menambahkan pustaka Queue-Fair Network-Edge Adapter hanya membutuhkan waktu beberapa menit dengan perubahan kode minimal pada penyedia cloud Anda untuk mengaktifkan dan menjalankan Adaptor, yang biasanya digunakan sebagai fungsi Lambda atau Edge Worker.

Mode Sederhana & Aman

Seperti halnya Adaptor Sisi-Server kami, Adaptor Tepi-Jaringan kami dapat beroperasi dalam mode Sederhana atau Aman.

Adaptor yang Tersedia

Adaptor Ruang Tunggu Virtual Virtual Amazon AWS CloudFront Network-Edge') ?>

CloudFront

Adaptor Ruang Tunggu Virtual Virtual Amazon AWS CloudFront Network-Edge.

Adaptor Ruang Tunggu Virtual Cloudflare Network-Edge

Cloudflare

Adaptor Ruang Tunggu Virtual Cloudflare Network-Edge

Adaptor Ruang Tunggu Virtual Virtual Jaringan-Tepi Jaringan yang Cepat

Fastly

Adaptor Ruang Tunggu Virtual Virtual Jaringan-Tepi Jaringan yang Cepat..

Adaptor Ruang Tunggu Virtual Akamai Network-Edge

Akamai

Akamai Network-Edge Virtual Waiting Room Adapter.



Halaman Antrian Dinamis

Seperti halnya Adaptor Sisi-Klien, data apa pun yang Anda inginkan dapat diteruskan dari situs Anda ke server kami dan Halaman Antrian yang dilihat pengunjung Anda dengan meneruskan informasi ini dalam panggilan Adaptor. Hal ini memfasilitasi Halaman Antrian Dinamis atau kustomisasi on-the-fly lainnya dengan cara yang sama - semua fitur Adaptor Sisi Klien didukung sepenuhnya. Silakan hubungi bagian dukungan jika Anda ingin mengaktifkan Halaman Antrian Dinamis pada akun Anda.

Sumber Daya Tambahan Adaptor Ujung-Jaringan

Adaptor Network-Edge kami sepenuhnya dijelaskan dalam Panduan Teknis. Panduan Teknis tersedia di bagian Portal Queue-Fair > Bantuan, atau Anda dapat meminta salinannya dari kami. Anda juga dapat menemukan informasi lebih lanjut tentang masing-masing Adaptor di README.md dari setiap repositori GitHub.


API REST

Queue-Fair memberikan akses kepada para pengembang ke enam Modul REST API. Anda memerlukan akun Queue-Fair untuk menggunakan API. Untuk mengaktifkan akses API untuk akun Anda, silakan hubungi Dukungan Queue-Fair. Modul API REST kami sesuai dengan standar OpenAPI, RFC 7807 dan RFC 3339.

Rangkaian Modul API kami komprehensif - apa pun yang dapat Anda lakukan di Portal, Anda juga dapat melakukannya dengan API, kecuali mengelola Pengguna Portal yang dikecualikan karena alasan privasi.

Setiap Modul API sepenuhnya didokumentasikan di api.queue-fair.net, di mana Anda juga akan menemukan antarmuka Swagger untuk kemudahan penggunaan dan pengujian. Untuk keamanan, semua panggilan API dilindungi oleh enkripsi TLS yang aman dan memerlukan Kunci API yang khusus untuk akun Anda.

Modul API

Pelaporan API

Untuk laporan langsung, real-time, laporan historis, dan statistik antrean agregat.

API Manajemen Antrian

Untuk membuat dan memodifikasi antrian secara terprogram dalam waktu nyata.

API Manajemen Akun

Untuk melihat dan memperbarui pengaturan seluruh akun Anda.

API Manajemen Aset

Untuk mengelola aset yang digunakan oleh Halaman Antrian Anda yang dilayani oleh Google CDN.

API Presentasi

Untuk mengubah aspek apa pun dari HTML Halaman Antrian Anda dan pembaruan serta pembuatan varian dengan cepat.

API Aktivasi

Untuk mengonfigurasi Aturan Aktivasi yang menentukan halaman mana di situs Anda yang dapat memicu antrean, dan halaman mana yang ditampilkan.



Halaman Antrian Dinamis

Anda juga dapat memodifikasi Halaman Antrian Anda dengan cepat tanpa harus memperbarui basis data menggunakan Portal atau API Presentasi - Hubungi Dukungan untuk rincian lebih lanjut dan untuk mengaktifkan Halaman Antrian Dinamis pada akun Anda.

REST API Sumber Daya Tambahan

Seperti yang disyaratkan oleh RFC 7807, Anda dapat menemukan dokumentasi tentang pesan kesalahan yang mungkin dikembalikan oleh Modul API REST kami di queue-fair.com/api-error


Aplikasi Asli

Queue-Fair terlihat bagus di browser seluler serta desktop dan laptop.

Anda juga dapat menggunakan Queue-Fair secara langsung di aplikasi iOS dan Android asli Anda, dan juga aplikasi React Native di iOS, Android, Windows, dan MacOS, untuk melindungi aktivitas atau operasi yang intensif sumber daya.

Queue-Fair App Adapters menggunakan WebClient untuk menampilkan tampilan Antrian khusus kepada pengguna Anda ketika layanan Anda terlalu sibuk, dengan fleksibilitas dan kemudahan penggunaan aplikasi Queue-Fair Portal.

Anda dapat mengantri pengguna dalam antrian yang sama dengan pengunjung situs web Anda, atau menyiapkan antrian terpisah untuk pengguna aplikasi Anda - terserah Anda.

Sama seperti antrian berbasis web kami, setiap tempat pengguna secara otomatis disimpan jika mereka menavigasi dari aplikasi Anda juga.

Repositori GitHub

iOS, MacOS dan Adaptor Ruang Tunggu Virtual Apple

iOS & MacOS

Repositori GitHub untuk Ruang Tunggu Virtual Queue-Fair iOS dan Adaptor MacOS.

Adaptor Ruang Tunggu Virtual Android

Android

Repositori GitHub untuk Adaptor Ruang Tunggu Virtual Queue-Fair untuk Android.

Aplikasi React Native Adaptor Ruang Tunggu Virtual

React Native

Repositori GitHub untuk Adaptor Ruang Tunggu Virtual Queue-Fair untuk aplikasi React Native untuk Android, iOS, MacOS dan Windows.

Pemberitahuan Antrian

Queue-Fair Adapter memudahkan pengiriman Push Notification kepada pengguna yang tidak menggunakan aplikasi atau antrian Anda ketika giliran mereka dipanggil. Tempat pengguna dalam antrian secara otomatis disimpan secara persisten oleh Adaptor di Aplikasi Anda. Jika pengguna menavigasi menjauh dari aplikasi Anda, aplikasi Anda memberi tahu server Push Notification Anda bahwa notifikasi harus dikirim, mengirimkan informasi posisi antrian yang tersimpan sebagai bagian dari pesan tersebut ke server Push Notification Anda.

Ini adalah teknologi yang sama yang kami gunakan untuk aplikasi konsumen WeQ4U kami, yang telah diunduh sekitar 2 juta kali di Inggris saja.

Server Push Notification Anda berkonsultasi dengan Queue-Fair Status API secara berkala untuk menanyakan posisi antrian yang saat ini sedang dilayani. Ketika ini lebih besar dari posisi antrian pengguna tertentu, inilah saatnya untuk mengirim pemberitahuan kepada pengguna tersebut. Jika pengguna kembali ke antrian atau Lulus sebelum Notifikasi Push dikirim, Adaptor memberi tahu aplikasi Anda, dan aplikasi Anda memberi tahu server Notifikasi Push Anda bahwa notifikasi tidak lagi diperlukan.

Sepengetahuan kami, kami adalah satu-satunya penyedia Ruang Tunggu Virtual yang mendukung fitur ini.

Sumber Daya Video

Berikut ini adalah video Native App Adapter yang sedang beraksi, menunjukkan bahwa tempat pengguna disimpan bahkan jika aplikasi benar-benar dihentikan, dan juga menunjukkan hook Adapter yang digunakan aplikasi Anda untuk mengirim Push Notifications.

Sumber Daya Tambahan

Adaptor Aplikasi Asli kami dijelaskan dalam Panduan Teknis. Panduan Teknis tersedia di bagian Portal Queue-Fair > Bantuan, atau Anda dapat meminta salinannya dari kami. Anda juga dapat menemukan informasi lebih lanjut tentang masing-masing Adaptor yang khusus untuk iOS dan Android di README.md dari setiap repositori GitHub.


Adaptor ECommerce

Queue-Fair dapat ditambahkan dengan mudah ke sistem eCommerce apa pun menggunakan Adaptor JavaScript Sisi Klien yang dijelaskan di atas.

Kami juga menawarkan kode Adaptor untuk bekerja di Server-Side dengan banyak server eCommerce populer.

Repositori GitHub

Magento Plugin

Magento

Repositori GitHub untuk Adaptor Ruang Tunggu Virtual Queue-Fair untuk Magento.

Adaptor Ruang Tunggu Virtual WooCommerce/PHP

WooCommerce

Repositori GitHub untuk Adaptor Ruang Tunggu Virtual Queue-Fair untuk WooCommerce di PHP.

Adaptor Ruang Tunggu Virtual PrestaShop/PHP

PrestaShop

Repositori GitHub untuk Adaptor Ruang Tunggu Virtual Queue-Fair untuk PrestaShop dalam PHP.

Sumber Daya Tambahan

Adaptor kami dijelaskan dalam Panduan Teknis. Panduan Teknis tersedia di Portal Queue-Fair > bagian Bantuan, atau Anda dapat meminta salinannya dari kami.

Kami juga memiliki Panduan tambahan yang tersedia untuk sebagian besar platform eCommerce - tanyakan saja yang Anda inginkan.


Keamanan Hibrida

Anda dapat dengan mudah menggabungkan fleksibilitas Adaptor JavaScript Sisi Klien dengan lapisan keamanan tambahan yang disediakan oleh kode Sisi Server kami.

Queue-Fair menandatangani setiap pengunjung yang kami lewati dengan sidik jari digital yang unik untuk Pengunjung tersebut. Uniknya di industri ini, tanda tangan juga menyertakan kode khusus untuk browser pengunjung, untuk mencegah token akses dibagikan.

Server web Anda dapat memvalidasi tanda tangan menggunakan rahasia yang hanya diketahui oleh Anda dan kami - bukan pengunjung Anda - untuk memastikan bahwa setiap pengunjung telah dilewati secara adil oleh server Queue-Fair.

Jadi, Anda dapat menggunakan Adaptor JavaScript Sisi-Klien untuk mengirim dan menerima pengunjung ke dan dari antrean, dan memeriksa gangguan sebelum mereka memesan dengan kode Sisi-Server yang minimal, dan menghindari memperkenalkan ketergantungan pada sistem kami.

Contoh kode disertakan dalam Repositori GitHub kami dalam setiap bahasa pemrograman web utama.

Repositori GitHub

PHP

PHP

Repositori GitHub untuk Adaptor Sisi Server Ruang Tunggu Virtual Queue-Fair dalam PHP.

Java

Java

Repositori GitHub untuk Queue-Fair Virtual Waiting Room Server-Side Adapter untuk Java, termasuk JBoss dan Tomcat.

Ruby

Ruby

Repositori GitHub untuk Adaptor Sisi Server Ruang Tunggu Virtual Queue-Fair di Ruby dan (opsional) Rails.

Python

Python

Repositori GitHub untuk Adaptor Sisi Server Ruang Tunggu Virtual Queue-Fair di Python dan (opsional) Django.

.NET

.NET

Repositori GitHub untuk Adaptor Sisi Server Ruang Tunggu Virtual Queue-Fair untuk .NET, ASP, dan C #.

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

Node.js & JavaScript

Repositori GitHub untuk Adaptor Sisi Server Ruang Tunggu Virtual Queue-Fair untuk Node.js dan (opsional) Express.

Sumber Daya Tambahan

Model Keamanan Hibrida dijelaskan sepenuhnya dalam Panduan Teknis. Panduan Teknis tersedia di bagian Portal Queue-Fair > Bantuan, atau Anda dapat meminta salinannya dari kami.


Lisensi

Kode publikasi kami yang tersedia di Repositori GitHub Queue-Fair dilisensikan di bawah Lisensi MIT, yang merupakan salah satu lisensi Open Source yang paling permisif.


Ingin tahu cara kerja Queue-Fair?