Praktični vodniki Qivo
Kako deluje API za ustvarjanje QR koda
API vam omogoča, da samodejno ustvarite QR kode s spletne strani, notranjega orodja ali scenarija.
Vaša aplikacija pošilja vsebino in nastavitve; Qivo vrne statično QR sliko.
Od redatelja do integratorja
V uredniku oseba izpolnjuje polja in klikne prenesete. s API, program izvaja te ukrepe, na primer ustvarjanje QR koda za stran izdelka med pripravo oznake.
API klic ne naredi kode dinamičnega. slika shranjuje predložene podatke namesto posredne Qivo URL. Lahko shranite in uporabite datoteko, ne da bi se znova obrnili na generator.
Kaj zahteva vsebuje
GET zahteva vsebuje naslov storitve, parametre in skrivni ključ. vsebinaType parameter izbere vrsto podatkov, format izbere PNG ali SVG, in obliko, mejo in središče nadzoruje zasnovo.
Vrednosti parametrov morajo biti kodirane z URL-jem. Uporabite standardna orodja v jeziku za pravilno upravljanje prostorov, + v telefonskih številkah in # v barvah. Nepravilna ali pomanjkanje potrebnih polj povzroča odziv na napako.
Zakaj je ključ na vašem strežniku
Ključ omogoča dostop do generacije. obiskovalci lahko preberejo ključ, ki je nameščen v javni strani JavaScript. Pošlji zahteve iz strežnika in naložite ključ iz spremenljivke okolja.
Pošljite ključ v naslovniku X-API-Key preko HTTPS. ključni URL parameter je podprt, vendar se lahko URL-ji pojavijo v zgodovini in dnevnikih. Nikoli ne postavite skrivnega ključa v QR sliko ali javnih primerov.
Kako ravnati z odzivom
Uspešen odgovor vsebuje sam sliko, ne JSON z povezavo za prenos. preverite status HTTP pred shranjevanjem. napake vrnejo JSON z razlago; ne shranite tega kot PNG.
SVG je uporaben za tiskane materiale, medtem ko PNG ustreza vsakodnevnim slikam. Izogibajte se regeneraciji koda na vsaki obisku nezmenjene strani: shranite in ponovno uporabite datoteko. Spoštujte omejitve zahteve in zamudo za odhod.
Kaj preveriti pred objavo
API potrjuje vnos, vendar ne dekodira končne slike. to zmanjša obdelavo, vendar mora vaš delovni tok opraviti skeniranje testiranja. preizkusite tipične oblikovne kombinacije in največje količine podatkov, ki jih pričakujete.
Pustite svetlo mirno območje najmanj štirih modulov, dober kontrast in zadostna velikost. skeniranje končnega tiskanega postavitve s telefonom. stran API vsebuje tehnične parametre in pripravljene za uporabo PHP, JavaScript, Python in cURL primere.
Viri in nadaljnje branje
Pripravljeno in vzdrževano z Umind. Preizkusite te priporočila na vašem končnem postavitvi in ciljnih napravah.