⚡XoderaPlugins
QR skener vmesnik. Načrtovane so enkratne akcije prehoda.
QR skener vmesnik. Načrtovane so enkratne akcije prehoda.
← Vsi izvorni vodiči

Xodera Plugins · Bubble Native

Xodera QR Passes Native

Ustvarite enkratne vstopnice, potrditve prevzema ali kupone. Osebje skenira kodo, preveri rezultat, predogleda naročilo in potrdi uporabo šele, ko je pripravljeno.

Public beta guides · Haptics instructions are in its Bubble listing

Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.

Ustvarite delovni tok ↓Nastavitve vtičnika ↗Native Lab

Dokumentacija pregledana 6 november 2026

Praktični primeri

Enkratni vstop za enodnevni dogodek

Posnetek zaslona običajne vrednosti QR se lahko sicer ponovno uporabi na več kot enem vhodu.

Vaša aplikacija shrani zapis o sprejemu in stabilno izdajo `request_id`; uporabite urejen `label=event` in `ttl_seconds` v okviru 1–86400-sekundni pogodbi.

Pooblaščeni izdajatelj izvede Issue QR pass in zasebno dostavi vrnjeni QR. Osebje skenira → Check QR pass → potrdi le, če sta `ok=yes` in `status=available` → Confirm QR redemption s shranjenim stabilnim ID zahteve.

Le `status=redeemed` skupaj z `receipt_id` dovoljuje, da vaša aplikacija izda potrdilo o vstopu. Referenco prepustnice/potrdila shranite v zapis Admission; vsebine QR ne razkrivajte analitiki.

Za `outcome_unknown` povrnite isto zahtevo z enakim uporabnikom/okoljem/prepustnico; nikoli ne ustvarite novega ID potrditve. Obdelajte expired, revoked in že uporabljena stanja kot ločene izide.

Načrtovano. Skeniranje in preverjanje ne porabita prepustnice; porabi jo samo izrecna potrditev.

Izkoristite kratkotrajno ugodnost enkrat pri partnerjevem pultu

Partner potrebuje potrjen rezultat uporabljenega/neuporabljenega namesto zaupanja v sliko QR ali animacijo zaslona.

`label=coupon`; zapis o ugodnosti aplikacije določa upravičenost in kratko obdobje veljavnosti pred pooblaščenim dejanjem izdaje.

Prepustnico izdajte šele po preverjanju upravičenosti v vaši aplikaciji. Pri pultu Check QR pass prikazuje razpoložljivost brez porabe. Ko osebje potrdi dostavo ugodnosti, zaženite Confirm QR redemption.

Vaš zapis o ugodnosti lahko shrani `receipt_id` in potrjen čas unovčitve po `status=redeemed`. Vtičnik upravlja stanje prepustnice; vaša aplikacija upravlja ugodnost in odnos s stranko.

Če je ugodnost preklicana pred uporabo, lahko isti pooblaščeni izdajatelj Revoke QR pass z uporabo njegovega `pass_id`. Ne objavite vračila ali uspešne unovčitve samo na podlagi `ok=yes`.

Načrtovano. Skeniranje in preverjanje ne porabita prepustnice; porabi jo samo izrecna potrditev.

Potrdite prevzem opreme ali naročila istega dne

Delovni tok osebja mora ločiti skeniranje reference za prevzem od dejanskega predajanja predmeta.

Zapis o lastni zbirki v vaši aplikaciji hrani pooblastilo, želeni predmet in ločene stabilne ID-je zahtev za izdajo/unovčenje; uporabite kratkotrajen `label=access`.

Po tem, ko vaša aplikacija odobri prevzem, Issue QR pass. Osebje skenira in preveri, pregleda ustrezno zbirko v vaši aplikaciji, nato izrecno potrdi predajo in Confirm QR redemption.

Šele po potrjenem prejemku `redeemed` naj vaš delovni tok nastavi zbirko kot predano. Ohranite `receipt_id` kot povezavo do izida potrditve.

Ponovljeno skeniranje lahko vrne already_used; prikažite obstoječi zapis aplikacije namesto predaje drugega predmeta. Povrnite nejasno potrditev z istim ID-jem in vhodnimi podatki.

Načrtovano. Skeniranje in preverjanje ne porabita prepustnice; porabi jo samo izrecna potrditev.

Kaj deluje zdaj

Zasebna beta. Trenutni skener ima nadzor kamere in dovoljenj. Ustvarjanje, preverjanje in potrjevanje enkratnih prepustnic je načrtovano in še ni pripravljeno za uporabo v vaši aplikaciji.

Ustvarite delovni tok

Načrtovano

Načrtovan potek dela. Še ni na voljo v trenutni beta različici.

Ti primeri uporabljajo zapise aplikacije, kot so Lesson, Message in Order. Zamenjajte jih s svojimi vrstami podatkov in imeni elementov. Primeri naslovov medijev je treba zamenjati s svojimi datotekami.

  1. Načrtovano: pooblaščeni zaposleni uporabi Issue QR pass za vstop ali Order. Primer: label=event, ttl_seconds=900, environment=development. Ohranite stabilen request_id za to izdajo in shranite pass_id skupaj z zapisom.

  2. Prikažite vrnjeni QR njegovemu nameravanemu imetniku. Osebje ga skenira. V načrtovanem delovnem toku prepustnice uporabite workflow_mode=yes in preberite scanned_pass_token po pass_scanned. Te nastavitve delovnega toka prepustnice niso na voljo v trenutnem skenerju.

  3. Zaženite Check QR pass z pass_token = QR Scanner's scanned_pass_token. Preveri brez uporabe prepustnice. Za status=available prikažite ustrezne podrobnosti naročila ali vnosa, da jih lahko osebje pregleda.

  4. Le ločen gumb Potrdi zažene Confirm QR redemption z istim pass_token, stabilnim request_id in confirm=yes. Ob status=redeemed shranite receipt_id in označite to naročilo ali vnos kot dokončano.

  5. already_used, expired, revoked ali invalid pomeni, da ne dovolite vstopa ali predaje naročila. Samo skeniranje ali uspešen Preverjanje ne dokončata transakcije.

Diagram delovnega toka — ne posnetek zaslona aplikacije

Nastavite enkrat

Ustvarite ali izberite svoj projekt aplikacije Bubble v BestPlugins → Dashboard → Plugins. Izberite Xodera QR Passes Native, kopirajte njegov ključ, nato odprite Bubble → Plugins → Xodera QR Passes Native in ga prilepite v project_api_key. Shranite enkrat; nato uporabite spodnje akcije. Vsak vtičnik v vsakem projektu ima svoj ključ.

Skeniranje zahteva dovoljenje za kamero. Za enkratne vstopnice določite, kdo sme ustvarjati vstopnice in kdo jih lahko preveri pri vhodu ali točki prevzema. Običajni kupci ne potrebujejo nobene vloge osebja.

qr_issuer_permission_field

qr_pass_issuer · Ime uporabniškega polja da/ne, ki označuje zaposlene, ki smejo ustvarjati ali preklicati prehode. Primer/privzeto: qr_pass_issuer. Vnesite tukaj ime polja, ne da ali ne. Le pooblaščeni skrbnik naj spreminja to dovoljenje za uporabnika.

qr_staff_permission_field

qr_staff · Ime uporabniškega polja da/ne, ki označuje osebje, ki sme preverjati in potrjevati uporabo. Primer/privzeto: qr_staff. Lastnik vstopnice ne potrebuje tega dovoljenja. Izključite ga iz javnih obrazcev za registracijo in profil.

Nastavite enkrat
  1. Ustvarite ali izberite svoj projekt aplikacije Bubble pri BestPlugins → Dashboard → Plugins.
  2. Izberite ta vtičnik in kopirajte njegov ključ projekta.
  3. Odprite Bubble → Plugins → Xodera QR Passes Native; prilepite ključ v project_api_key in shranite.
  4. Dodajte element, izberite svoje podatke aplikacije in sestavite spodnji potek dela.
  5. Zasebni beta dostop je zaenkrat edini. Javno nameščanje in plačana aktivacija še nista na voljo.
Namestitev in naročnina

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

Shrani rezultat v vašo aplikacijo

Primer vstopa ali prevzema: shranite povezano naročilo/dogodek, pass_id, expires_at in issue_request_id. Po potrjeni uporabi dodajte receipt_id, redeemed_at in zaposlenega, ki je potrdil. Ne označite zapisa kot dokončanega, ko je koda le skenirana ali preverjena. Koda QR ne potrjuje identitete osebe.

Napaka, preklic in obnovitev

Če outcome_unknown=yes, obdržite isto vstopnico, request_id in vnose pri ponovnem preverjanju rezultata. Ne ustvarjajte nove potrditve. already_used, expired in revoked so končni poslovni rezultati. Če je dovoljenje zavrnjeno, prosite pooblaščenega administratorja, da pregleda vlogo zaposlenega. Clear session ponastavi skener; ne more razveljaviti zaključene uporabe.

Zmožnosti in omejitve

Načrtovane prepustnice so enkratne, z življenjsko dobo 1–86400 sekund; privzeto 900. Vrste prepustnic: access, event, coupon in membership. Preverjanje ne rezervira prepustnice. Za uporabo prepustnice je potreben dostop do interneta. Ni obdelave plačil, preverjanja identitete ali večkratno uporabne dolgoročne članske izkaznice. Branje običajne vrednosti QR je ločeno od preverjanja prepustnice.

Nastavitve, dejanja in rezultati

Uporabite ta imena v Bubble. Načrtovane funkcije so označene ločeno.

Razpoložljive beta nastavitve

Nastavitve elementa

disabled · yes/nois_active · yes/noui_text_json · textlanguage · text

Stanja

scanner_status · textserver_status · textpass_id · textpass_label · textreceipt_id · texterror_code · textis_busy · yes/nois_scanning · yes/notorch_enabled · yes/noscan_source · textpending_redemption · yes/no

Dogodki

scanner_startedscanner_pausedscanner_cancelledpermission_deniedpass_scannedvalidation_startedvalidation_completedredemption_startedpass_redeemedredemption_rejectedredemption_pendingfixture_decodedqr_error

Dejanja in njihovi vnosi

Clear session
Nastavitve elementa · 5

Načrtovan potek dela. Še ni na voljo v trenutni beta različici.

disabledyes/no · Privzeto: false
Primer vrednostino
Primer Bubble izrazaGuideHost's is_busy (your yes/no custom state)
Onemogoči element, ko je vaša aplikacija zasedena ali ko je to dejanje nedostopno.
is_activeyes/no · Privzeto: true
Primer vrednostiyes
Primer Bubble izrazaGuideHost's view_is_active (your yes/no custom state)
Nastavi da, ko je ta pogled odprt. Nastavi ne, ko zapuščate, da se predvajanje ali trenutno delo lahko ustavi.
ui_text_jsontext · Privzeto: "{}"
Primer vrednosti{}
Primer Bubble izrazaApp Settings' player_labels_json (supported keys only)
Izbirni JSON s podprtimi oznakami gumbov. Pustite prazno za uporabo vgrajenega besedila.
languagetext · Privzeto: "auto"
Primer vrednostiuk
Primer Bubble izrazaCurrent User's preferred_language
Nastavite language=auto, da sledi podprti napravi ali jeziku brskalnika. Vnesite podprto kodo jezika, da ga izberete izrecno.
workflow_modeyes/no · Privzeto: false
Primer vrednostiyes
Primer Bubble izrazaApp Settings' use_qr_business_actions
Načrtovano: omogočiti, da skenirana vrednost QR uporabi Check QR pass. Samo skeniranje ne potrdi vnosa ali prevzema.
Dejanja in njihovi vnosi · 5

Načrtovan potek dela. Še ni na voljo v trenutni beta različici.

Clear session

Ni parametrov dejanja

Issue QR pass
environmenttext · Privzeto: "development"
Primer vrednostidevelopment
Primer Bubble izrazaApp Settings' selected_environment
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
request_idtext · Privzeto: —
Primer vrednostipickup-123-issue-v1
Primer Bubble izrazaCurrent Admission's stable_request_id
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
labeltext · Privzeto: "access"
Primer vrednostievent
Primer Bubble izrazaSelected Admission's pass_label
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
ttl_secondsnumber · Privzeto: 900
Primer vrednosti900
Primer Bubble izrazaEvent Settings' pass_ttl_seconds
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.

Vrnjeno

pass_id · textpass_token · textpass_label · textexpires_at · textqr_png_data_uri · textreused · yes/no
Check QR pass
environmenttext · Privzeto: "development"
Primer vrednostidevelopment
Primer Bubble izrazaApp Settings' selected_environment
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
pass_tokentext · Privzeto: —
Primer vrednosti<opaque token returned by Issue / camera scan>
Primer Bubble izrazaQR Pass Scanner's scanned_pass_token (capture before Check)
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.

Vrnjeno

pass_label · textexpires_at · text
Confirm QR redemption
environmenttext · Privzeto: "development"
Primer vrednostidevelopment
Primer Bubble izrazaApp Settings' selected_environment
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
pass_tokentext · Privzeto: —
Primer vrednosti<opaque token returned by Issue / camera scan>
Primer Bubble izrazaQR Pass Scanner's scanned_pass_token (capture before Check)
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
request_idtext · Privzeto: —
Primer vrednostipickup-123-redeem-v1
Primer Bubble izrazaCurrent Admission's stable_redemption_request_id
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
confirmyes/no · Privzeto: false
Primer vrednostiyes — explicit confirmation only
Primer Bubble izrazaConfirm Checkbox is checked
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.

Vrnjeno

pass_id · textpass_label · textreceipt_id · textredeemed_at · textreused · yes/no
Revoke QR pass
environmenttext · Privzeto: "development"
Primer vrednostidevelopment
Primer Bubble izrazaApp Settings' selected_environment
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.
pass_idtext · Privzeto: —
Primer vrednosti<pass_id returned by Issue>
Primer Bubble izrazaSelected Admission's pass_id
Uporabi vrednost trenutnega poslovnega zapisa; preveri jo glede na spodnje omejitve.

Vrnjeno

pass_id · textrevoked · yes/no
Stanja in dogodki

Načrtovan potek dela. Še ni na voljo v trenutni beta različici.

Stanja

scanner_status · text

Trenutni rezultat tega dejanja. Uporabite ustrezen dogodek dokončanja pred shranjevanjem uspeha. idle,requesting_permission,permission_denied,scanning,paused,scanned,validating,available,redeeming,redeemed,unavailable,unknown,error,cancelled,decoding_fixture,fixture_decoded

server_status · text

Trenutni rezultat tega dejanja. Uporabite ustrezen dogodek dokončanja pred shranjevanjem uspeha. empty,available,redeemed,already_used,expired,revoked

pass_id · text

Identifikator za ta element ali dejanje. Obdržite ga z ustreznim zapisom aplikacije. Uporabite isti identifikator zahteve pri ponovnem poskusu nejasnega rezultata.

pass_label · text

Trenutna vrednost izbranega elementa. Preberite jo po povezanem dogodku. empty,access,event,coupon,membership

receipt_id · text

Identifikator za ta element ali dejanje. Obdržite ga z ustreznim zapisom aplikacije. Uporabite isti identifikator zahteve pri ponovnem poskusu nejasnega rezultata.

error_code · text

Podatki o napaki za zadnje dejanje. Prikažite koristno sporočilo in ponudite ustrezen ponovni poskus.

is_busy · yes/no

Delo je še v teku. Počakajte, preden začnete drugo dejanje.

is_scanning · yes/no

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

torch_enabled · yes/no

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

scan_source · text

Trenutna vrednost izbranega elementa. Preberite jo po povezanem dogodku. empty,camera,fixture

pending_redemption · yes/no

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

scanned_pass_token · text

Trenutna vrednost za izbrani element. Preberite jo po povezanem dogodku.

Dogodki

scanner_started

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

scanner_paused

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

scanner_cancelled

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

permission_denied

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

pass_scanned

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

validation_started

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

validation_completed

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

redemption_started

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

pass_redeemed

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

redemption_rejected

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

redemption_pending

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

fixture_decoded

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

qr_error

Ko se ta dogodek zgodi, preberite povezane stanje iz istega elementa.

Vprašanja, ki jih postavljajo razvijalci

Kaj pomenita dve nastavitvi dovoljenj?

Ime polja uporabnika da/ne, ki označuje zaposlene, ki smejo ustvarjati ali preklicati prehode. Primer/privzeto: qr_pass_issuer. Tukaj vnesite ime polja, ne da ali ne. Le pooblaščeni administrator naj spreminja to dovoljenje pri uporabniku. Ime polja uporabnika da/ne, ki označuje osebje, ki sme preverjati in potrjevati uporabo. Primer/privzeto: qr_staff. Lastnik vstopnice tega dovoljenja ne potrebuje. Izključite ga iz javnih obrazcev za registracijo in profile.

Ali lahko isti zaposleni ustvarja in preverja prehode?

Da, če pooblaščeni administrator zaposlenemu dodeli obe dovoljenji. To ne zahteva dodatnega ključa projekta. Stranke običajno ne potrebujejo nobenega od dovoljenj. Uporabnikom ne dovolite, da si sami dodelijo ta dovoljenja.

Zakaj uporabiti Preverjanje po Skeniranju?

Skeniranje prebere kodo. Preverjanje sprašuje, ali je prehod na voljo brez uporabe. Osebje lahko najprej pregleda naročilo. Le ločeno dejanje Confirm QR redemption uporabi prehod enkrat.

Kako deluje naročnina?

Načrtovana cena: namestitev vtičnika v Bubble je brezplačna. Dostop do BestPlugins je ločena naročnina za vsak vtičnik v vsakem Bubble projektu aplikacije: 7 dni brezplačno, nato US$1.50 na mesec. Development in Live sta vključena. Ni fiksne omejitve števila operacij; omejitve velikosti datotek in funkcij še vedno veljajo. Blagajna še ni odprta. Aktivacijski zaslon bo prikazal prvi datum obračuna in pogoje preklica.

Povezani vodniki

audio-playervideo-playerphoto-editoraudio-recorderoffline-filesdocuments-aib2-files

Marketplace izdaja v teku

Vodič foruma ni objavljen

Za pomoč nam povejte, kateri vtičnik in napravo uporabljate, kakšno dejanje ste poskusili in kaj se je zgodilo. Uporabite primer brez osebnih podatkov. Nikoli ne delite svojega ključa ali zasebnih datotek.