Qivo gyakorlati útmutató
Hogyan működik a QR kód generációs API
Az API lehetővé teszi, hogy a webhelyen, belső eszközön vagy forgatókönyvben automatikusan QR kódokat generáljon.
Az alkalmazás tartalmat és beállításokat küld; a Qivo statikus QR képet ad vissza.
A kézi szerkesztőből az integrációig
A szerkesztőben egy személy feltölti a mezőket, és kattintson a letöltésre. API-vel a program végrehajtja ezeket az intézkedéseket, például egy terméklap QR kódját generálva egy címke elkészítésekor.
Az API hívás nem teszi dinamikusvá a kódot.A kép tárolja a benyújtott adatokat, nem pedig egy közbenső Qivo URL-t. A fájlt újra megmentheti és használhatja anélkül, hogy újra kapcsolatba lépne a generátorral.
Mit tartalmaz egy kérés
A GET kérés tartalmazza a szolgáltatás címét, paramétereket és titkos kulcsot. A tartalomType paraméter kiválasztja az adat típusát, a formátum kiválasztja a PNG vagy SVG-t, és a formatervezés, a határ és a központ irányítja a tervezést.
A paraméter értékei URL-kódolásban kell lenniük.A nyelv standard eszközeinek használata helyesen kezeli a helyeket, a + telefonszámokat és a # színeket.Az érvénytelen vagy hiányzó szükséges mezők hibás válaszot okoznak.
Miért van a kulcs a kiszolgálón
A kulcs hozzáférést biztosít a generációhoz.A látogatók olvashatják a nyilvános oldal JavaScript-jében található kulcsot.Kérdéseket küldjenek a szerverről, és töltse le a kulcsot egy környezeti változóból.
Küldje el a kulcsot az X-API-Key címkével a HTTPS-en keresztül. A kulcs URL paraméter is támogatott, de az URL-k megjelenhetnek a történelemben és a naplókban. Soha ne tegye a titkos kulcsot a QR kép vagy a nyilvános példákban.
Hogyan kezeljük a választ
A sikeres válasz magában foglalja a képet, nem pedig a JSON-t egy letöltés linkrel. Ellenőrizze a HTTP állapotát mentés előtt. Hiba visszatér a JSON-hoz egy magyarázatgal; ne mentse azt PNG-ként.
SVG hasznos a nyomtatott anyagok, míg PNG illeszkedik a mindennapi képek. Kerülje a regenerálódás egy kódot minden látogatás egy változatlan oldalon: mentse és használja újra a fájlt.
Mit kell ellenőrizni a közzététel előtt
Az API validálja a bevitelt, de nem dekódolja a kész képet. Ez csökkenti a feldolgozást, de a munkafolyamatnak meg kell kezelni a szkennelési teszteléseket. Teszteli a tipikus tervezési kombinációkat és a legnagyobb adatmennyiségeket várja.
Hagyjon egy könnyű csendes zónát legalább négy modulból, jó kontrasztból és elegendő méretből. Scan a végső nyomtatott elrendezést telefonon. Az API oldal tartalmaz technikai paramétereket és használatra kész PHP, JavaScript, Python és cURL példákat.
Források és további olvasás
Készített és karbantartott Umind. Tesztelje ezeket az ajánlásokat a végleges elrendezésén és a céleszközökön.