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