Panduan Praktikal Qivo
Bagaimana API Pengeluaran Kod QR Berfungsi
API membolehkan anda menghasilkan kod QR secara automatik daripada laman web anda, alat dalaman atau skrip.
Aplikasi anda menghantar kandungan dan tetapan; Qivo mengembalikan imej QR statik. kunci rahsia kekal pada pelayan anda.
Dari editor manual kepada integrasi
Dalam editor, seseorang mengisi medan dan klik muat turun.Dengan API, program menjalankan tindakan ini, contohnya menghasilkan kod QR halaman produk semasa menyiapkan label.
Panggilan API tidak menjadikan kod dinamik. imej menyimpan data yang dikemukakan bukannya URL Qivo. anda boleh menyimpan dan menggunakan fail tanpa menghubungi generator lagi.
Apa yang dimasukkan dalam permohonan
Permintaan GET mengandungi alamat perkhidmatan, parameter dan kunci rahsia. kandunganTipe parameter memilih jenis data, format memilih PNG atau SVG, dan bentuk, sempadan dan pusat mengawal reka bentuk. teks rata memerlukan medan data.
Nilai parameter mesti disulitkan URL. Gunakan alat standard bahasa anda untuk mengendalikan ruang dengan betul, + dalam nombor telefon dan # dalam warna. medan yang tidak sah atau hilang yang diperlukan menyebabkan tindak balas ralat.
Mengapa kunci terletak pada pelayan anda
Kunci membolehkan akses kepada pengeluaran.Pelawat boleh membaca kunci yang diletakkan dalam JavaScript halaman awam.Hantar permintaan daripada pelayan anda dan muat kunci dari variabel persekitaran.
HTTPS. parameter URL kunci juga disokong, tetapi URL boleh muncul dalam sejarah dan log. Jangan pernah meletakkan kunci rahsia anda dalam imej QR atau contoh awam.
Bagaimana untuk mengendalikan jawapan
Jawapan yang berjaya mengandungi imej itu sendiri, bukan JSON dengan pautan muat turun. semak status HTTP sebelum simpan. kesilapan mengembalikan JSON dengan penjelasan; jangan simpan itu sebagai PNG.
SVG berguna untuk bahan cetak, manakala PNG sesuai dengan imej harian. elakkan regenerasi kod pada setiap lawatan ke halaman yang tidak berubah: simpan dan gunakan semula fail. menghormati had permintaan dan keterlambatan Retry-After.
Apa yang perlu diperiksa sebelum menerbitkan
API mengesahkan input tetapi tidak mendekodkan imej selesai. ini mengurangkan pemprosesan, tetapi aliran kerja anda perlu mengendalikan ujian pemindaian. Ujian kombinasi reka bentuk tipikal dan jumlah data terbesar yang anda jangkakan.
Tinggalkan zon tenang yang ringan sekurang-kurangnya empat modul, kontras yang baik dan saiz yang mencukupi. Scan tataletak percetakan akhir dengan telefon. Halaman API mengandungi parameter teknikal dan bersedia untuk digunakan contoh PHP, JavaScript, Python dan cURL.
Sumber dan bacaan lanjut
Dipersiapkan dan diselenggarakan oleh Umind. Ujian cadangan ini pada tataletak akhir dan peranti sasaran anda.