Практически ръководства на Qivo
Как работи API за генериране на QR код
API ви позволява да генерирате QR кодове автоматично от вашия уебсайт, вътрешен инструмент или скрипт.
Приложението ви изпраща съдържание и настройки; Qivo връща статична QR картина.
От ръчен редактор до интеграция
В редактора, човек попълва полета и кликват за изтегляне.С API, програма изпълнява тези действия, например генериране на QR код на страницата на продукта, докато подготвя етикет.
Призивът за API не прави кода динамичен.Снимката съхранява подадените данни, а не посредствен URL Qivo.Можете да съхранявате и използвате файла, без да се свързвате отново с генератора.
Какво съдържа искането
Запитване за GET съдържа адресът на услугата, параметрите и таен ключ. съдържаниетоType параметър избира типа данни, форматът избира PNG или SVG, а формата, границата и центъра контролират дизайна.
Използвайте стандартните инструменти на вашия език, за да управлявате правилно пространствата, + в телефонните номера и # в цветовете. Невалидни или липсващи изисквани полета причиняват реакция на грешка.
Защо ключът принадлежи на вашия сървър
Посетителите могат да четат ключ, поставен в JavaScript на публична страница. изпратете искания от сървъра си и заредете ключа от променлива среда.
Изпратете ключа в заглавието X-API-Key чрез HTTPS. Ключовият URL параметър също се поддържа, но URL адресите могат да се появят в историята и записи. Никога не поставяйте тайния ключ в QR изображението или публичните примери.
Как да се справим с отговора
Успешният отговор съдържа самата картина, а не JSON с връзка за изтегляне. Проверете статуса на HTTP преди да спестите. Грешките се връщат на JSON с обяснение; не го спестите като PNG.
SVG е полезен за печатните материали, докато PNG се отнася до ежедневните изображения. Избягвайте регенериране на код при всяко посещение на непроменена страница: съхранявайте и преизползвайте файла.
Какво да проверим преди публикуването
API валидира входа, но не декодира завършената картина. Това намалява обработката, но работното ви течение трябва да се справя с сканираните тестове. Тества типичните комбинации от дизайн и най-големите обеми данни, които очаквате.
Оставяйте светла тиха зона от най-малко четири модула, добър контраст и достатъчен размер. Скениране на окончателното отпечатано оформление с телефон. Страницата на API съдържа технически параметри и готови за употреба PHP, JavaScript, Python и cURL примери.
Източници и по-нататъшно четене
Подготвени и поддържани от Umind. Тествайте тези препоръки на крайния си дизайн и целеви устройства.