Praktické průvodce Qivo
Jak funguje QR kód generace API
API vám umožňuje automaticky generovat QR kódy z vašeho webu, interního nástroje nebo skriptů.
Vaše aplikace odesílá obsah a nastavení; Qivo vrací statický QR obraz. Tajný klíč zůstává na vašem serveru.
Od manuálního editoru až po integraci
V editoru osoba vyplní pole a klikne na stahování. s API program provádí tyto akce, například generování QR kódu na stránce produktu při přípravě štítku.
API volání neznamená, že kód bude dynamický. obrázek ukládá předložené údaje namísto střední Qivo URL. Můžete uložit a použít soubor bez opětovného kontaktu s generátorem.
Co žádost obsahuje
Žádost o GET obsahuje adresu služby, parametry a tajný klíč. obsahType parametr vybere typ dat, formát vybere PNG nebo SVG a tvar, hranice a centrum ovládá design.
Hodnoty parametrů musí být kódovány URL. Použijte standardní nástroje vašeho jazyka, abyste správně zvládli prostory, + v telefonních číslech a # v barvách. Nevhodné nebo chybějící požadované pole způsobují chybovou odpověď.
Proč je klíč na serveru
Návštěvníci si mohou přečíst klíč umístěný v JavaScript veřejné stránky. Odeslat žádosti z vašeho serveru a nahrát klíč z proměnné prostředí.
Odeslat klíč do klíče X-API přes HTTPS. Klíčový parametr URL je také podporován, ale URL se mohou objevit v historii a záznamech. Nikdy nechte svůj tajný klíč do QR obrazu nebo veřejných příkladů.
Jak řešit odpověď
Úspěšná odpověď obsahuje samotný obrázek, ne JSON s odkazem na stahování. Zkontrolujte stav HTTP před ušetřením. Chyby vrátí JSON s vysvětlením; nezachovejte to jako PNG.
SVG je užitečný pro tiskové materiály, zatímco PNG se hodí k každodenním snímkům. Vyhněte se regeneraci kódu při každé návštěvě nezměněné stránky: uložte a znovu použijte soubor. Dodržujte požadavky limitů a odkládání.
Co zkontrolovat před publikací
API ověřuje vstup, ale nedekoduje hotový obrázek. To snižuje zpracování, ale váš pracovní tok musí zvládnout skenování testování. Testovat typické designové kombinace a největší data objemu očekáváte.
Zanechte lehkou klidnou zónu nejméně čtyř modulů, dobrý kontrast a dostatečnou velikost. Skenujte konečný tiskový rozvrh pomocí telefonu. Stránka API obsahuje technické parametry a připravené pro použití příklady PHP, JavaScript, Python a cURL.
Zdroj a další čtení
Vyzkoušejte tyto doporučení na vašem konečném rozložení a cílových zařízeních.