Qivo praktické sprievodcovia
Ako funguje generácia QR kódu API
API vám umožňuje automaticky generovať QR kódy z vašej webovej stránky, vnútorného nástroja alebo skriptov.
Vaša aplikácia odošle obsah a nastavenia; Qivo vráti statický QR obraz. Tajný kľúč zostáva na vašom serveri.
Od manuálneho editoru až po integráciu
V editor, osoba vyplní polia a klikne na stiahnutie. s API, program vykonáva tieto akcie, napríklad generovať QR kód produktovej stránky pri príprave štítku.
Pozvánka API neznamená, že kód bude dynamický. obrázok ukladá predložené údaje namiesto sprostredkovanej URL Qivo. Môžete uložiť a použiť súbor bez kontaktu s generátorom znova.
Čo žiadosť obsahuje
Požiadavka GET obsahuje adresu služby, parametre a tajný kľúč. obsahType parameter vyberá typ údajov, formát vyberá PNG alebo SVG a tvar, hranice a centrum ovláda dizajn.
Hodnoty parametrov musia byť kódované URL. Použite štandardné nástroje vášho jazyka na správne zaobchádzanie s priestormi, + v telefónnych číslach a # v farbách. Neplatné alebo chýbajúce požadované polia spôsobujú odpoveď na chybu.
Prečo je kľúč na vašom serveri
Kľúč poskytuje prístup k generácii. Návštevníci si môžu prečítať kľúč umiestnený v javnom JavaScript na verejnej stránke. Odoslať žiadosti z servera a nahrať kľúč z environmentálnej variabily.
Odoslať kľúč v hlavičke X-API-Key cez HTTPS. Kľúčový parameter URL je tiež podporovaný, ale URL sa môžu zobrazovať v histórii a záznamoch. Nikdy nezadajte tajný kľúč v QR obraze alebo verejných príkladoch.
Ako zaobchádzať s reakciou
Úspešná odpoveď obsahuje obraz sám, nie JSON s odkazom na stiahnutie. skontrolujte stav HTTP pred uložením. Chyby vrátia JSON s vysvetlením; nezachráňte to ako PNG.
SVG je užitočný pre tlačené materiály, zatiaľ čo PNG vyhovuje každodenným obrázkom. Vyhnite sa regenerácii kódu pri každej návšteve nezmenenej stránky: uložiť a znovu použiť súbor. dodržiavať limity žiadosti a odkladu Retry-After.
Čo skontrolovať pred vydaním
API validuje vstup, ale nekóduje hotový obrázok. To znižuje spracovanie, ale váš pracovný tok musí zvládnuť skenovanie testovania. Testovať typické dizajnové kombinácie a najväčšie objemy údajov očakávate.
Zanechajte ľahkú tichú zónu s najmenej štyri moduly, dobrý kontrast a dostatočnú veľkosť. Skenujte konečný tlačený rozloženie pomocou telefónu. Stránka API obsahuje technické parametre a príklady pripravené na použitie PHP, JavaScript, Python a cURL.
Zdroj a ďalšie čítanie
Vyskúšajte tieto odporúčania na vašom konečnom usporiadaní a cieľových zariadeniach.